Aufgabe:

Benachrichtigung, dass eine Drilldown-Aktion durchgeführt werden soll.

Aktivierung:

LlSetOption(hJob, LL_OPTION_DRILLDOWNPARAMETER,
    (LPARAM)&oMyDrillDownParameters);

Parameter:

lParam zeigt auf eine scLlDrillDownJob-Struktur:

_nSize: Größe der Struktur

_nFunction: Die durchzuführende Aufgabe. Es gibt zwei verschiedene Aufgaben:

_nUserParameter: Wert, der mit LL_OPTION_DRILLDOWNPARAMETER übergeben wurde

_pszTableID: Zeiger auf einen String, der den Namen der Eltern-Tabelle enthält.

_pszRelationID: Zeiger auf einen String, der den Namen der Relation zwischen Eltern- und Child-Tabelle enthält.

_pszSubreportTableID: Zeiger auf einen String, der den Namen der Child-Tabelle enthält.

_pszKeyField: Zeiger auf einen String, der den Namen des Schlüsselfeldes der Eltern-Tabelle enthält. Wenn die Relation mehrere Schlüsselfelder benötigt (geteilter Primärschlüssel) erhalten Sie diese hier Tab-getrennt. Beachten Sie auch die Dokumentation zu LlDbAddTableRelationEx().

_pszSubreportKeyField: Zeiger auf einen String, der den Namen des Schlüsselfeldes der Child-Tabelle enthält. Wenn die Relation mehrere Schlüsselfelder benötigt (geteilter Primärschlüssel) erhalten Sie diese hier Tab-getrennt. Beachten Sie auch die Dokumentation zu LlDbAddTableRelationEx().

_pszKeyValue: Zeiger auf einen String, der den Inhalt des Schlüsselfeldes der Eltern-Tabelle enthält. Wenn die Relation mehrere Schlüsselfelder benötigt (geteilter Primärschlüssel) erhalten Sie die Werte hier Tab-getrennt. Beachten Sie auch die Dokumentation zu LlDbAddTableRelationEx().

_pszProjectFileName: Name des auszugebenden Projektes.

_pszPreviewFileName: Name der zu erstellenden Vorschaudatei.

_pszTooltipText: Zeiger auf einen String, der den Tooltip-Text enthält, wenn man mit der Maus über einen Eintrag in der Tabelle steht, welche einen Subreport (Drilldown) auslösen soll.

_pszTabText: Zeiger auf einen String, der auf der Lasche angezeigt wird, wenn der Benutzer den Drilldown-Bericht auf einer Lasche angezeigt haben möchte.

_hWnd: Fensterhandle, um eigene Dialoge anzeigen zu können (Fenster-Handle des Vorschau-Controls).

_nID: Enthält die eindeutige DrilldownJobID; nicht mit dem List & Label Druckjob zu verwechseln. Diese wird bei FINALIZE auf den Wert gesetzt, der bei START als Rückgabewert des Callbacks bestimmt wurde. Dies ermöglicht Ihrem Programm eine eindeutige Zuordnung der Drilldown-Jobs.

_hAttachInfo: Dieser Parameter wird für LlAssociatePreviewControl() benötigt, um den Viewer attachen zu können. Zusätzlich müssen die beiden Flags LL_­ASSOCIATE­PREVIEW­CONTROLFLAG_­DELETE_­ON_­CLOSE und LL_­ASSOCIATE­PREVIEW­CONTROLFLAG_­HANDLE_­IS_­ATTACH­INFO übergeben werden. Weitere Hinweise dazu finden Sie in Kapitel Direkter Druck und Export aus dem Designer.

Rückgabewert (_lResult):

Geben Sie einen Wert zurück, der für die gesamte Laufzeit der Anwendung eindeutig ist.

Hinweise:

Dieser Callback wird immer im Kontext des Vorschau Threads aufgerufen, unabhängig davon, ob er aus der Echtdatenvorschau im Designer oder aus dem direkten Vorschaudruck heraus aufgerufen wurde.

Beispiele:

Siehe Kapitel Direkter Druck und Export aus dem Designer