Funktionreferenz


WinActive

Beschreibung anzeigen in

Prüft, ob das angegebene Fenster existiert und gerade aktiv ist.

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

Parameter

title Der Titel, das Handle oder die Klasse des Fensters, das geprüft werden soll. Siehe Erweiterte Fenstertiteldefinition.
text [optional] Der Text des Fensters, das geprüft werden soll. Standardwert ist ein Leerstring. Siehe Erweiterte Fenstertextdefinition.

Rückgabewert

Erfolg: das Handle des Fensters, wenn es aktiv ist.
Fehler: ansonsten 0.

Verwandte Funktionen

WinExists, WinTitleMatchMode (Option), WinWait, WinWaitActive, WinWaitClose, WinWaitNotActive

Beispiel

#include <MsgBoxConstants.au3>

If WinActive("[CLASS:Notepad]") Then ; Prüft, ob das Editorfenster das aktive Fenster ist.
    MsgBox($MB_SYSTEMMODAL, "", "WinActive" & @CRLF & "Notepad ist das aktive Fenster.")
Else
    MsgBox($MB_SYSTEMMODAL, "", "WinActive" & @CRLF & "Notepad ist nicht das aktive Fenster.")
EndIf