Funktionsreferenz

WinGetHandle

Ermittelt das Handle eines Fensters.

WinGetHandle ( "title" [, "text"] )

Parameter

title Der Titel des Fensters, das gelesen werden soll. Siehe Erweiterte Fenstertiteldefinition.
text [optional] Der Text des Fensters, das gelesen werden soll.

Rückgabewert

Erfolg: Gibt die Fenster-ID (Handle) als String zurück.
Fehler: Gibt einen leeren String ("") zurück und setzt @error = 1, wenn kein Fenster die Kriterien erfüllt.

Bemerkungen

Diese Funktion ist wichtig für die Nutzung der erweiterten "WinTitleMatchMode" Optionen, die es ermöglichen anstelle von Fenstertiteln und / oder Fenstertexten Klassennamen (classnames) und Fenster-IDs (Handles) zur Fensterbestimmung zu nutzen.
Wird das Fenster über Fenster-IDs ausgewählt, kann es auch erreicht werden, wenn der Titel wechselt.

Verwandte Funktionen

WinSetTitle, GUICreate, WinList

Beispiel


; Damit das Beispiel funktioniert, muss mindestens ein geöffnetes Notepad existieren, in dem "hier rein" vorkommt!

; Ermittelt das Handle des vordersten Editor-Fensters, welches "hier rein" enthält.
Local $handle = WinGetHandle("classname=Notepad", "hier rein")
If @error Then
    MsgBox(4096, "Fehler", "Das richtige Fenster konnte nicht gefunden werden")
Else
    ; Es wird etwas Text in das Änderungsfeld des Fensters geschrieben.
    ControlSend($handle, "", "Edit1", " AbCdE")
EndIf