Syntax:

FARPROC LlSetNotificationCallbackExt (HLLJOB hJob, INT nEvent, FARPROC lpfnNotify);

Aufgabe:

Definition einer Prozedur, die bei Notifications des genannten Events aufgerufen werden soll.

Parameter:

hJob: List & Label-Job-Handle

nEvent: Event-ID (LL_CMND_xxx oder LL_NTFY_xxxx)

lpfnNotify: die Adresse einer Funktion (s. u.)

Rückgabewert:

Adresse der übergebenen Funktion (oder NULL, wenn Fehler)

Hinweise:

Die "spezialisierte" Callback-Funktion hat höhere Priorität als die "generelle" Callback-Funktion oder eine Callback-Nachricht.

List & Label sucht demnach zuerst, ob es für den Event, den es auslösen möchte, einen über diese Funktion definierten "spezialisierten" Callback gibt. Wenn ja, wird dieser aufgerufen. Anderenfalls überprüft List & Label, ob ein über LlSet­NotificationCallback() definierter "unspezifischer" Callback definiert ist und ruft dann diesen auf. Ansonsten überprüft List Label, ob eine Nachrichten-Nummer über LlSetNotificationMessage() definiert ist und sendet dann diese Nachricht gesendet.

Diese Funktion darf auch genutzt werden, wenn Callbacks direkt verwendet werden, d. h. bei OCX oder VCL. Nicht aber bei der .NET-Komponente, da diese diese Funktion schon für sich verwendet.

Die Callback-Funktion hat folgende Definition:

   LPARAM WINAPI MyCallback(UINT nFunction, LPARAM lParam)

und muss eine exportierte Funktion sein.

Die Bedeutung der Parameter nFunction und lParam können Sie in dem Kapitel über die Callback-Objekte nachlesen.

Beispiel:

LPARAM WINAPI MyCallback(UINT nFunction, LPARAM lParam)

{ //....}

HLLJOB hJob;

unsigned int wMsg;

hJob = LlJobOpen(0);

v = LlSetNotificationCallbackExt(hJob, LL_CMND_CHANGE_DCPROPERTIES_DOC, MyCB);

// ....

LlJobClose(hJob);

Siehe auch:

LlSetNotificationCallback