| Operatoren |
set_content_update_callback — Setzen einer Callback-Funktion bei Aktualisierung des Pufferinhalts.
set_content_update_callback( : : WindowHandle, CallbackFunction, CallbackContext : )
set_content_update_callback setzt die Callback-Funktion CallbackFunction, die immer dann aufgerufen wird, wenn sich der Inhalt des Pufferfensters WindowHandle ändert. Der Parameter CallbackContext wird dabei immer an die Callback-Funktion übergeben.
Der Typ der Callback-Funktion CallbackFunction ist: Herror callback(void *context)
Auf Windows Systemen wird die __stdcall calling convention verwendet: Herror __stdcall callback(void *context)
Die Callback-Funktion darf keinen HALCON Operator aufrufen. Dies ist undefiniertes Verhalten. Es wird empfohlen, nur wenig rechenintensive Aufgaben in der Callback-Funktion durchzuführen, z.B. das Setzen eines Flags oder das Anstoßen einer asynchronen Operation.
In Verbindung mit den Operatoren send_mouse_down_event, send_mouse_up_event und send_mouse_double_click_event kann set_content_update_callback verwendet werden, um ein Fenster-Control für ein GUI Toolkit wie Qt zu erstellen. Das Controll leitet Mausevents an den Puffer weiter, welcher das Control bei Änderungen des Fensterinhalts benachrichtigt, indem er CallbackFunction aufruft. Das Control kann dann den Inhalt das Puffers mit dump_window_image kopieren und schließlich anzeigen.
Fenster-Handle.
Callback Funktion bei Aktualisierung des Pufferinhalts.
Parameter für CallbackFunction.
set_content_update_callback liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist. Ansonsten wird eine Fehlerbehandlung durchgeführt.
Foundation
| Operatoren |