GuiFromHwnd

Ruft das Gui-Objekt eines GUI-Fensters über dessen Fensterhandle ab.

GuiObj := GuiFromHwnd(Hwnd , ElternfensterSuchen)

Parameter

Hwnd

Typ: Integer

Das Fensterhandle (HWND) eines GUI-Fensters, das zuvor vom Skript erstellt wurde, oder, wenn ElternfensterSuchen True ist, das Fensterhandle eines Unterfensters des GUI-Fensters, das vom Skript erstellt wurde.

ElternfensterSuchen

Typ: Boolesch

Wenn dieser Parameter True ist und Hwnd ein Unterfenster identifiziert, das keine GUI ist, versucht die Funktion das nächste Elternfenster abzurufen, das eine GUI ist. Andernfalls gibt die Funktion eine leere Zeichenkette zurück, wenn Hwnd nicht direkt ein GUI-Fenster identifiziert.

Rückgabewert

Typ: Objekt oder Zeichenkette (leer)

Diese Funktion gibt das Gui-Objekt zurück, das mit dem angegebenen Fensterhandle verknüpft ist, oder eine leere Zeichenkette, wenn das zugehörige Objekt nicht gefunden wurde oder das Fensterhandle ungültig ist.

Bemerkungen

Das Fensterhandle eines GUI-Fensters kann z.B. an eine OnMessage-Funktion übergeben oder z.B. mit Gui.Hwnd oder WinExist abgerufen werden.

Gui(), Gui-Objekt, GuiControl-Objekt, GuiCtrlFromHwnd, Steuerelemente, ListView, TreeView, Menu-Objekt, Control-Funktionen, MsgBox, FileSelect, DirSelect

Beispiele

Ruft das Gui-Objekt über das Fensterhandle des gerade erstellten GUI-Fensters ab und meldet dessen Titel.

MeineGui := Gui(, "Fenstertitel")
MeineGui.Add("Text",, "Beliebiger Anzeigetext.")
MeineGui.Show()

MsgBox(GuiFromHwnd(MeineGui.Hwnd).Title)