WinWait

Wartet, bis ein bestimmtes Fenster existiert.

WinWait , FensterTitel, FensterText, Zeitlimit, AusnahmeTitel, AusnahmeText

Parameter

FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

Mindestens einer dieser Parameter ist erforderlich. Geben Sie für FensterTitel einen Fenstertitel oder andere Kriterien zur Identifizierung des Zielfensters und/oder für FensterText eine Teilzeichenkette aus einem Textelement des Zielfensters an (Textelemente können mit dem internen Tool "Window Spy" in Erfahrung gebracht werden).

AusnahmeTitel und AusnahmeText können verwendet werden, um ein oder mehrere Fenster anhand ihres Titels oder Textes auszuschließen. Ihre Angabe ähnelt der von FensterTitel und FensterText, außer dass AusnahmeTitel keine anderen Kriterien als den Fenstertitel erkennt.

Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Standardmäßig werden versteckte Fenster nicht erkannt und versteckte Textelemente erkannt, was mit DetectHiddenWindows und DetectHiddenText geändert werden kann. Standardmäßig muss ein Fenstertitel mit dem angegebenen FensterTitel oder AusnahmeTitel beginnen, um eine Übereinstimmung zu sein, was mit SetTitleMatchMode geändert werden kann.

Zeitlimit

Wenn leer oder weggelassen, wird der Befehl unendlich lang warten. Andernfalls geben Sie die maximale Wartezeit in Sekunden an. Um auf einen Bruchteil einer Sekunde zu warten, geben Sie eine Floating-Point-Zahl an, z.B. 0.25, um maximal 250 Millisekunden zu warten. Die Angabe von 0 entspricht der Angabe von 0.5. Dieser Parameter kann ein Ausdruck sein.

ErrorLevel

ErrorLevel wird auf 1 gesetzt, wenn der Befehl das Zeitlimit überschritten hat, andernfalls auf 0.

Bemerkungen

Der Befehl hört bereits auf zu warten, wenn ein passendes Fenster gefunden wird, und nicht erst, wenn Zeitlimit abgelaufen ist. In diesem Fall wird ErrorLevel sofort auf 0 gesetzt, das Zuletzt Gefundene Fenster aktualisiert und die Skriptausführung fortgesetzt.

Während der Befehl wartet, können neue Threads via Hotkeys, benutzerdefinierte Menüpunkte oder Timer gestartet werden.

Wenn ein anderer Thread den Inhalt der Variablen ändert, die für die Parameter dieses Befehls verwendet wurden, sieht der Befehl die Änderung nicht, d.h. der Befehl verwendet weiterhin den Titel und Text, die ursprünglich in den Variablen vorhanden waren, als der Befehl zu warten begann.

Im Gegensatz zu WinWaitActive kann hier nicht das Zuletzt Gefundene Fenster verwendet werden. Daher muss mindestens einer der Fensterparameter (FensterTitel, FensterText, AusnahmeTitel, AusnahmeText) einen nicht-leeren Wert enthalten.

WinWaitActive, WinWaitClose, WinExist(), WinActive(), Process, SetTitleMatchMode, DetectHiddenWindows

Beispiele

Öffnet Notepad und wartet maximal 3 Sekunden, bis es existiert. Wenn WinWait das Zeitlimit überschreitet, wird eine Fehlermeldung angezeigt, andernfalls wird Notepad minimiert.

Run, notepad.exe
WinWait, Unbenannt - Editor,, 3
if ErrorLevel
{
    MsgBox, WinWait hat das Zeitlimit überschritten.
    return
}
else
    WinMinimize ; Verwendet das von WinWait gefundene Fenster.