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 der VCL-Komponente, nicht aber bei der .NET-Komponente, da diese die 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