Syntax:

INT LlDbAddTableRelation(HLLJOB hJob, LPCTSTR pszTableID, LPCTSTR pszParentTableID, LPCTSTR pszRelationID, LPCTSTR pszRelationDisplayName);

Aufgabe:

Meldet eine Beziehung zwischen zwei Tabellen für das Design und den Druck an. Die Tabelle steht dem Benutzer dann im Designer als Untertabelle der Elterntabelle zur Verfügung und kann zur Druckzeit von List & Label angefordert werden.

Parameter:

hJob: List & Label-Job-Handle

pszTableID: ID der Kindtabelle. Diese muss mit der bei LlDbAddTable() übergebenen ID übereinstimmen.

pszParentTableID: ID der Elterntabelle. Diese muss mit der bei LlDbAddTable() übergebenen ID übereinstimmen.

pszRelationID: ID der Relation. Diese wird bei LlPrintDbGetCurrentTableRelation() zurückgeliefert, wenn die Kindtabelle gedruckt werden soll. Muss innerhalb eines Drucks eindeutig sein.

pszRelationDisplayName: Name der Relation wie er im Designer angezeigt wird. 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.

Rückgabewert:

Fehlercode

Hinweise:

Beachten Sie die Hinweise im Kapitel Drucken relationaler Daten. Zum Aufrufzeitpunkt müssen die Eltern- und Kindtabelle bereits mit LlDbAddTable() angemeldet worden sein.

Beispiel:

HLLJOB hJob;
hJob = LlJobOpen(0);

LlDbAddTable(hJob, "Orders", NULL);
LlDbAddTable(hJob, "OrderDetails", NULL);
LlDbAddTableRelation(hJob, "OrderDetails", "Orders",
   "Orders2OrderDetails", NULL);
<... etc ...>
LlJobClose(hJob);

Siehe auch:

LlDbAddTable, LlDbAddTableSortOrder, LlPrintDbGetCurrentTable, LlPrintDbGet-CurrentTableSortOrder, LlPrintDbGetCurrentTableRelation