KlassenKlassenKlassenKlassen | | | | Operatoren

attach_background_to_windowattach_background_to_windowAttachBackgroundToWindowattach_background_to_windowAttachBackgroundToWindowAttachBackgroundToWindow (Operator)

Name

attach_background_to_windowattach_background_to_windowAttachBackgroundToWindowattach_background_to_windowAttachBackgroundToWindowAttachBackgroundToWindow — Setzen des Hintergrundbildes eines HALCON-Fensters.

Signatur

attach_background_to_window(Image : : WindowHandle : )

Herror attach_background_to_window(const Hobject Image, const Hlong WindowHandle)

Herror T_attach_background_to_window(const Hobject Image, const Htuple WindowHandle)

Herror attach_background_to_window(Hobject Image, const HTuple& WindowHandle)

void HWindow::AttachBackgroundToWindow(const HImage& Image) const

void HDrawingObject::AttachBackgroundToWindow(const HImage& Image, const HTuple& WindowHandle)

void AttachBackgroundToWindow(const HObject& Image, const HTuple& WindowHandle)

void HWindow::AttachBackgroundToWindow(const HImage& Image) const

static void HDrawingObject::AttachBackgroundToWindow(const HImage& Image, const HWindow& WindowHandle)

void HOperatorSetX.AttachBackgroundToWindow(
[in] IHUntypedObjectX* Image, [in] VARIANT WindowHandle)

void HWindowX.AttachBackgroundToWindow([in] IHImageX* Image)

void HDrawingObjectX.AttachBackgroundToWindow(
[in] IHImageX* Image, [in] IHWindowX* WindowHandle)

static void HOperatorSet.AttachBackgroundToWindow(HObject image, HTuple windowHandle)

void HWindow.AttachBackgroundToWindow(HImage image)

static void HDrawingObject.AttachBackgroundToWindow(HImage image, HWindow windowHandle)

Beschreibung

attach_background_to_windowattach_background_to_windowAttachBackgroundToWindowattach_background_to_windowAttachBackgroundToWindowAttachBackgroundToWindow setzt das Hintergrundbild ImageImageImageImageImageimage des HALCON-Fensters WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle. Das Eingabebild wird kopiert, so dass es sicher wieder gelöscht werden kann.

Das Hintergrundbild wird sofort im HALCON-Fenster angezeigt, wenn attach_background_to_windowattach_background_to_windowAttachBackgroundToWindowattach_background_to_windowAttachBackgroundToWindowAttachBackgroundToWindow aufgerufen wird. Alle HALCON-Objekte, die bisher in diesem Fenster angezeigt wurden, werden auch weiterhin dargestellt. Somit wird der bisherige Fensterinhalt nicht überschrieben.

Der Fensterinhalt wird in der folgenden Reihenfolge dargestellt: Zuerst das Hintergrundbild, dann HALCON-Objekte und anschließend die Zeichenobjekte. Somit wird ein Zeichenobjekt immer an der obersten Ebene dargestellt. Das Fenster wird für jede Benutzerinteraktion innerhalb des Fensters und jeden Aufruf von disp_objdisp_objDispObjdisp_objDispObjDispObj aktualisiert. HALCON-Objekte können durch einen Aufruf von clear_windowclear_windowClearWindowclear_windowClearWindowClearWindow bzw. clear_windowclear_windowClearWindowclear_windowClearWindowClearWindow vom Fenster entfernt werden.

Das Hintergrundbild kann mit dem Operator detach_background_from_windowdetach_background_from_windowDetachBackgroundFromWindowdetach_background_from_windowDetachBackgroundFromWindowDetachBackgroundFromWindow wieder von dem Fenster entfernt werden.

Achtung

Es sollte kein Operator, der auf die Event-Queue des HALCON-Fensters zugreift, wie z.B. get_mbuttonget_mbuttonGetMbuttonget_mbuttonGetMbuttonGetMbutton oder read_charread_charReadCharread_charReadCharReadChar, verwendet werden, solange Zeichenobjekte ans Fenster anhgehängt sind. Sie stehen im Gegensatz zu der Interaktion mit Zeichenobjekten, da sie aktiv auf die Eventloop des Fensters zugreifen.

Außerdem sollte keiner der blockierenden Operatoren draw_rectangle1draw_rectangle1DrawRectangle1draw_rectangle1DrawRectangle1DrawRectangle1, draw_rectangle2draw_rectangle2DrawRectangle2draw_rectangle2DrawRectangle2DrawRectangle2, draw_regiondraw_regionDrawRegiondraw_regionDrawRegionDrawRegion, draw_xlddraw_xldDrawXlddraw_xldDrawXldDrawXld oder draw_circledraw_circleDrawCircledraw_circleDrawCircleDrawCircle zusammen mit der Event-Funktionalität verwendet werden, da sie die Interaktion mit Zeichenobjekten verhindern.

Parallelisierung

Parameter

ImageImageImageImageImageimage (input_object)  singlechannelimage objectHImageHImageHImageHImageXHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / int8 / real / complex / vector_field)

Hintergrundbild.

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Fenster-Handle.

Ergebnis

attach_background_to_windowattach_background_to_windowAttachBackgroundToWindowattach_background_to_windowAttachBackgroundToWindowAttachBackgroundToWindow liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow

Nachfolger

detach_background_from_windowdetach_background_from_windowDetachBackgroundFromWindowdetach_background_from_windowDetachBackgroundFromWindowDetachBackgroundFromWindow

Modul

Foundation


KlassenKlassenKlassenKlassen | | | | Operatoren