Funktionreferenz

WinExists

Beschreibung anzeigen in

Prüft, ob ein bestimmtes Fenster existiert.

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

Parameter

title Der Titel/Fenster-Handle(hWnd)/Klassenname(class) des Fensters, dessen Existenz überprüft werden soll. Siehe Erweiterte Fenstertiteldefinition.
text [optional] Der Text des Fensters, das geprüft werden soll. Standardwert ist ein leerer String. Siehe Erweiterte Fenstertextdefinition.

Rückgabewert

Erfolg: 1
Fehler: 0 wenn das Fenster nicht gefunden wurde

Bemerkungen

WinExists() gibt auch 1 zurück, wenn das Fenster versteckt ist.

Verwandte Funktionen

ProcessExists, WinActive, WinClose, WinTitleMatchMode (Option), WinWait, WinWaitActive, WinWaitClose, WinWaitNotActive

Beispiel

#include <MsgBoxConstants.au3>

Example()

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

    ; Wartet maximal 10 Sekunden bis der Editorfenster erscheint.
    WinWait("[CLASS:Notepad]", "", 10)

    ; Prüft, ob das Editorfenster existiert und zeigt das Ergebnis.
    If WinExists("[CLASS:Notepad]") Then
        MsgBox($MB_SYSTEMMODAL, "", "Das Fenster existiert.")
    Else
        MsgBox($MB_SYSTEMMODAL + $MB_ICONERROR, "", "Das Fenster existiert nicht.")
    EndIf

    ; Schließt das Editorfenster.
    WinClose("[CLASS:Notepad]", "")
EndFunc   ;==>Example