WinWaitActive / WinWaitNotActive

Wartet, bis ein bestimmtes Fenster aktiv oder nicht aktiv ist.

WinWaitActive FensterTitel, FensterText, Zeitlimit, AusnahmeTitel, AusnahmeText
WinWaitNotActive FensterTitel, FensterText, Zeitlimit, AusnahmeTitel, AusnahmeText

Parameter

FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

Typ: Zeichenkette, Integer oder Objekt

Wenn jeder dieser Parameter leer ist oder weggelassen wird, wird das Zuletzt Gefundene Fenster verwendet. Andernfalls 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 kann ein Fenstertitel den angegebenen FensterTitel oder AusnahmeTitel an beliebiger Stelle enthalten, um eine Übereinstimmung zu sein, was mit SetTitleMatchMode geändert werden kann.

Zeitlimit

Typ: Integer oder Float

Wenn weggelassen, wird die Funktion 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.

Rückgabewert

Typ: Integer

WinWaitActive gibt die HWND-Nummer (eindeutige ID) des aktiven Fensters zurück, wenn es den Kriterien entspricht, oder 0, wenn die Funktion das Zeitlimit überschritten hat.

WinWaitNotActive gibt 1 zurück, wenn das aktive Fenster nicht den Kriterien entspricht, oder 0, wenn die Funktion das Zeitlimit überschritten hat.

Bemerkungen

Die Funktion hört bereits auf zu warten, wenn ein aktives Fenster gefunden wird, und nicht erst, wenn Zeitlimit abgelaufen ist. In diesem Fall wird sofort die Skriptausführung fortgesetzt.

Da "A" mit dem jeweils aktiven Fenster übereinstimmt, wartet WinWaitNotActive "A" normalerweise unendlich lang. Um stattdessen zu warten, bis ein anderes Fenster aktiv wird, geben Sie wie folgt dessen eindeutige ID an:

WinWaitNotActive WinExist("A")

Sowohl WinWaitActive als auch WinWaitNotActive werden das Zuletzt Gefundene Fenster aktualisieren, wenn zu Beginn der Funktion ein passendes Fenster aktiv ist oder wenn eines aktiv wird, während die Funktion wartet.

Während die Funktion 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 dieser Funktion verwendet wurden, sieht die Funktion die Änderung nicht, d.h. die Funktion verwendet weiterhin den Titel und Text, die ursprünglich in den Variablen vorhanden waren, als die Funktion zu warten begann.

WinWait, WinWaitClose, WinExist, WinActive, SetTitleMatchMode, DetectHiddenWindows

Beispiele

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

Run "notepad.exe"
if WinWaitActive("Unbenannt - Editor", , 2)
    WinMinimize ; Verwendet das von WinWaitActive gefundene Fenster.
else
    MsgBox "WinWaitActive hat das Zeitlimit überschritten."