Syntax:

INT LlDbAddTableSortOrder(HLLJOB hJob, LPCTSTR pszTableID, LPCTSTR pszSortOrderID, LPCTSTR pszSortOrderDisplayName, LPCTSTR pszField);

Aufgabe:

Meldet eine Sortierung einer Tabelle für das Design und den Druck an. Die Sortierung steht dem Benutzer dann im Designer zur Verfügung und kann zur Druckzeit von List & Label angefordert werden. Zusätzlich können die sortierungsrelevanten Felder Tab-separiert übergeben werden, so dass diese bei LlGetUsedIdentifiers() berücksichtigt werden können.

Parameter:

hJob: List & Label-Job-Handle

pszTableID: ID der Tabelle, für die die Sortierung bereitgestellt wird. Diese muss mit der bei LlDbAddTable() übergebenen ID übereinstimmen.

pszSortOrderID: ID der Sortierung. Diese wird bei LlPrintDbGetCurrentTableSort­Order() zurückgeliefert, wenn die Tabelle mit der entsprechenden Sortierung gedruckt werden soll.

pszSortOrderDisplayName: Name der Sortierung 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.

pszField: Tab-separierte Liste der sortierungsrelevanten Felder, sofern diese bei LlGetUsedIdentifiers() berücksichtigt werden sollen.

Rückgabewert:

Fehlercode

Hinweise:

Beachten Sie die Hinweise im Kapitel Drucken relationaler Daten. Zum Aufrufzeitpunkt muss die Tabelle bereits mit LlDbAddTable() angemeldet worden sein.

Beispiel:

HLLJOB hJob;
hJob = LlJobOpen(0);

LlDbAddTable(hJob, "Orders", NULL);
LlDbAddTableSortOrderEx(hJob, "Orders", "Name ASC", "Name [+]",
   "Orders.Name");
<... etc ...>
LlJobClose(hJob);

Siehe auch:

LlDbAddTableSortOrder, LlDbAddTable, LlDbAddTableRelation, LlPrintDbGet­CurrentTable, LlPrintDbGetCurrentTableSortOrder, LlPrintDbGetCurrent­Table­Relation