Funktionreferenz

WinWaitActive

Beschreibung anzeigen in

Unterbricht die Ausführung eines Skripts bis das angegebene Fenster aktiv ist.

WinWaitActive ( "title" [, "text" [, timeout = 0]] )

Parameter

title Der Titel/Fenster-Handle(hWnd)/Klassenname(class) des Fensters, auf das gewartet werden soll. Siehe Erweiterte Fenstertiteldefinition.
text [optional] Der Text des Fensters, auf das gewartet werden soll. Standardwert ist ein leerer String. Siehe Erweiterte Fenstertextdefinition.
timeout [optional] Maximale Unterbrechungsdauer nach der fortgefahren wird, auch wenn das Fenster noch nicht aktiv ist. Standardwert ist 0 (es wird ewig gewartet).

Rückgabewert

Erfolg: Das Handle des gewünschten Fensters.
Fehler: 0 wenn die maximale Unterbrechungszeit überschritten wurde.

Bemerkungen

Das Fenster wird ungefähr alle 250 Millisekunden abgefragt.

Verwandte Funktionen

ProcessWait, WinActive, WinExists, WinWait, WinWaitClose, WinWaitDelay (Option), WinWaitNotActive

Beispiel

Example()

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

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

    ; Wartet 2 Sekunden um das Editorfenster darzustellen.
    Sleep(2000)

    ; Schließt das Editorfenster durch die Verwendung des Klassennamens (classname) vom Editor.
    WinClose("[CLASS:Notepad]")
EndFunc   ;==>Example