combit List & Label - Programmierer-Referenz - combit GmbH

Callbacks und Notifications
11.3. Definition einer Callbackroutine
Eine Callbackroutine wird wie ein normaler Windows-Callback definiert. Zu speziellen
Fragen wie Compiler-Switches bedienen Sie sich bitte des Handbuchs zu Ihrem Compiler.
Die allgemeine Form des Callbacks ist in C-Notation
LRESULT CALLBACK _extern LLCallback(INT nMsg, LONG lParam,DWORD lUserParam);
bzw. in Delphi-Notation:
function LLCallback(nMsg: integer; lParam: longint, lUserParam: longint) :
longint; external;
Die Funktion kann direkt übergeben werden:
LlSetNotificationCallback(hJob,(FARPROC)LLCallback);
Ab jetzt kann Ihre Routine von List & Label aufgerufen werden, wenn dies nötig ist.
Wichtig ist, am Programmende den Callback wieder auf NULL zu setzen:
134
LlSetNotificationCallback(hJob,(FARPROC)NULL);
11.4. Datenübergabe an die Callbackroutine
Der Wert des nMsg-Parameters unterscheidet die verschiedenen Aufgaben. Die Werte
sind die Konstanten, die mit LL_CMND_xxxx beginnen, z.B. LL_CMND_TABLEFIELD zum
Zeichnen des Hintergrunds eines Tabellenfeldes, oder LL_INFO_xxx sowie LL_NTFY_xxx-
Nachrichten.
Abhängig von der Aufgabe, die Ihr Programm zu erledigen hat, erhält der Parameter
lParam unterschiedliche Bedeutungen. Die einzelnen Bedeutungen stehen weiter unten
bei den Aufgaben beschrieben. Es sind meist Strukturen (Records), auf die lParam zeigt,
der Wert muss also über eine Typkonvertierung in einen Strukturzeiger verwandelt werden:
LRESULT CALLBACK _extern LLCallback(INT wParam, LONG lParam, LONG lUserParam)
{
PSCLLTABLEFIELD pSCF;
switch (wParam)
{
case LL_CMND_TABLEFIELD:
pSCF = (PSCLLTABLEFIELD)lParam;
// do something using pSCF;
break;
}
return(0);
}
Die Funktion muss immer einen definierten Wert zurückgeben. Wenn nicht anders gefordert,
muss dieser Wert Null sein.