WinGetHandle
Beschreibung anzeigen in
Ermittelt das Handle eines Fensters.
WinGetHandle ( "title" [, "text"] )
Parameter
| title | Der Titel, das Handle oder die Klasse des Fensters, dessen Handle erhalten werden soll. Siehe Erweiterte Fenstertiteldefinition. |
| text | [optional] Der Text des Fensters, dessen Handle erhalten werden soll. Standardwert ist ein Leerstring. Siehe Erweiterte Fenstertextdefinition. |
Rückgabewert
| Erfolg: | ein Handle zu dem Fenster |
| Fehler: | Setzt das @error Flag auf ungleich null, wenn kein Fenster gefunden wurde. |
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
GUICreate, WinList, WinSetTitle
Beispiel
#include <MsgBoxConstants.au3>
Example()
Func Example()
; Startet den Editor
Run("notepad.exe")
; Wartet maximal 10 Sekunden bis das Editorfenster erscheint.
WinWait("[CLASS:Notepad]", "", 10)
; Ermittelt das Handle das Editorfensters durch die Verwendung des Klassennamens (classname) vom Editor.
Local $hWnd = WinGetHandle("[CLASS:Notepad]")
If @error Then
MsgBox($MB_SYSTEMMODAL, "", "Es trat ein Fehler auf als versucht wurde das Fensterhandle des Editors zu ermitteln.")
Exit
EndIf
; Zeigt das Handle des Editorfensters.
MsgBox($MB_SYSTEMMODAL, "", $hWnd)
; Schließt das Editorfenster durch die Verwendung des von WinGetHandle zurückgegebenen Handles.
WinClose($hWnd)
EndFunc ;==>Example