Funktionreferenz

WinGetClassList

Beschreibung anzeigen in

Liest die Klassennamen eines Fensters aus.

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

Parameter

title Der Titel/Fenster-Handle(hWnd)/Klassenname(class) des Fenster, dessen Klassennamen gelesen werden sollen. Siehe Erweiterte Fenstertiteldefinition.
text [optional] Der Text des Fensters, dessen Klassennamen gelesen werden sollen. Standardwert ist ein leerer String. Siehe Erweiterte Fenstertextdefinition.

Rückgabewert

Erfolg: Ein String mit den Klassennamen des Fensters.
Fehler: "" (leerer String) und setzt das @error Flag auf ungleich null, die Kriterien auf kein Fenster passen.

Bemerkungen

Klassennamen werden durch einen Zeilenvorschub (linefeed = @LF) voneinander getrennt. WinGetClassList() arbeitet sowohl mit minimierten, als auch versteckten Fenstern. Bis zu 64KB Text können ausgelesen werden. Falls mehrere Fenster das Kriterium erfüllen, werden die Klassennamen des zuletzt aktiven Fensters gelesen.

Verwandte Funktionen

ControlCommand, WinGetText

Beispiel

#include <MsgBoxConstants.au3>

Example()

Func Example()
    ; Startet den Editor
    Run("notepad.exe")

    ; Wartet maximal 10 Sekunden bis das Editorfenster erscheint.
    Local $hWnd = WinWait("[CLASS:Notepad]", "", 10)

    ; Ermittelt den Klassennamen (classlist) des Editorfenster durch die Verwendung des von WinWait zurückgegebenen Handles.
    Local $sClassList = WinGetClassList($hWnd)

    ; Zeigt den Klassennamen an.
    MsgBox($MB_SYSTEMMODAL, "", $sClassList)

    ; Schließt das Editorfenster durch die Verwendung des von WinWait zurückgegebenen Handles.
    WinClose($hWnd)
EndFunc   ;==>Example