Syntax:
INT LlDbAddTableEx(HLLJOB hJob, LPCTSTR pszTableID, LPCTSTR pszDisplayName, UINT nOptions);
Aufgabe:
Meldet eine Tabelle oder ein Datenbankschema für das Design und den Druck an und erlaubt die Übergabe weiterer Optionen. Die Tabelle steht dem Benutzer dann im Designer zur Verfügung und kann zur Druckzeit von List & Label angefordert werden.
Parameter:
hJob: List & Label-Job-Handle
pszTableID: ID der Tabelle. Diese wird bei LlPrintDbGetCurrentTable() zurückgeliefert, wenn die Tabelle gedruckt werden soll. Wenn Sie einen Leerstring oder NULL übergeben, wird der Tabellenpuffer gelöscht.
pszDisplayName: Name der Tabelle wie er im Designer angezeigt werden soll. Wird nur zur Anzeige verwendet und nicht im Projektfile gespeichert. Kann auch NULL sein, in diesem Falle wird der zweite Parameter auch für die Anzeige im Designer verwendet.
nOptions: Eine Kombination der folgenden Flags:
|
Wert |
Bedeutung |
|
LL_ADDTABLEOPT_SUPPORTSSTACKEDSORTORDERS |
Im Designer werden für diese Tabelle mehrfache Sortierungen unterstützt. LlDbGetCurrentTableSortOrder() liefert in diesem Falle eine tabulatorgetrennte Liste von Sortierungen zurück. |
|
LL_ADDTABLEOPT_-SUPPORTSADVANCEDFILTERING |
Unterstützung für die Übersetzung von Filterausdrücken in native Syntax. Siehe die Dokumentation des LL_QUERY_EXPR2HOSTEXPRESSION Callbacks und LlPrintDbGetCurrentTableFilter(). |
Rückgabewert:
Fehlercode
Hinweise:
Wenn ein Tabellenname mit "." angegeben wird, wird daraus ein Schema erzeugt.
Beachten Sie die Hinweise im Kapitel Drucken relationaler Daten.
Beispiel:
HLLJOB hJob;
hJob = LlJobOpen(0);
LlDbAddTable(hJob,
"", NULL);
LlDbAddTable(hJob, "Orders", NULL);
LlDbAddTable(hJob,
"OrderDetails", NULL);
LlDbAddTable(hJob, " HumanResources.Employee", NULL);
// scheme info
<... etc ...>
LlJobClose(hJob);
Siehe auch:
LlDbAddTableSortOrder, LlDbAddTableRelation, LlPrintDbGetCurrentTable, LlPrintDbGetCurrentTableSortOrder, LlPrintDbGetCurrentTableRelation