Syntax:

INT LlDbAddTableRelationEx(HLLJOB hJob, LPCTSTR pszTableID, LPCTSTR pszParentTableID, LPCTSTR pszRelationID, LPCTSTR pszRelationDisplayName, LPCTSTR pszKeyField, LPCTSTR pszParentKeyField);

Aufgabe:

Meldet eine Beziehung zwischen zwei Tabellen für das Design und den Druck an, insbesondere bei der Verwendung von Drilldown-Funktionalität. Die Tabelle steht dem Benutzer dann im Designer als Untertabelle der Elterntabelle zur Verfügung und kann zur Druckzeit von List & Label angefordert werden. Durch die Parameter pszKeyField und pszParentKeyField kann eine eindeutige Zuordnung für Drilldown erfolgen.

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.

pszKeyField: Schlüsselfeld der Kindtabelle, mehrere Schlüsselfelder als TAB-getrennte Liste

pszParentKeyField: Schlüsselfeld der Elterntabelle, mehrere Schlüsselfelder als TAB-getrennte Liste

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:

Siehe Kapitel Direkter Druck und Export aus dem Designer

Siehe auch:

LlDbAddTable, LlDbAddTableSortOrder, LlPrintDbGetCurrentTable, LlPrintDbGet-CurrentTableSortOrder, LlPrintDbGetCurrentTableRelation