<script src="../static/ga4.js" type="text/javascript"></script> </head> <body> <h1>WinWait</h1> <p>Wartet, bis ein bestimmtes Fenster existiert.</p> <pre class="Syntax">HWND := <span class="func">WinWait</span>(<span class="optional">FensterTitel, FensterText, Zeitlimit, AusnahmeTitel, AusnahmeText</span>)</pre> <h2 id="Parameters">Parameter</h2> <dl> <dt>FensterTitel, FensterText, AusnahmeTitel, AusnahmeText</dt> <dd> <p>Typ: <a href="../Concepts.htm#strings">Zeichenkette</a>, <a href="../Concepts.htm#numbers">Integer</a> oder <a href="../Concepts.htm#objects">Objekt</a></p> <p>Mindestens einer dieser Parameter ist erforderlich. Geben Sie für <em>FensterTitel</em> einen <a href="../misc/WinTitle.htm">Fenstertitel oder andere Kriterien</a> zur Identifizierung des Zielfensters und/oder für <em>FensterText</em> eine Teilzeichenkette aus einem Textelement des Zielfensters an (Textelemente können mit dem internen Tool "Window Spy" in Erfahrung gebracht werden).</p> <p><em>AusnahmeTitel</em> und <em>AusnahmeText</em> können verwendet werden, um ein oder mehrere Fenster anhand ihres Titels oder Textes auszuschließen. Ihre Angabe ähnelt der von <em>FensterTitel</em> und <em>FensterText</em>, außer dass <em>AusnahmeTitel</em> keine anderen Kriterien als den Fenstertitel erkennt.</p> <p>Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Standardmäßig werden versteckte Fenster nicht erkannt und versteckte Textelemente erkannt, was mit <a href="DetectHiddenWindows.htm">DetectHiddenWindows</a> und <a href="DetectHiddenText.htm">DetectHiddenText</a> geändert werden kann. Standardmäßig kann ein Fenstertitel den angegebenen <em>FensterTitel</em> oder <em>AusnahmeTitel</em> an beliebiger Stelle enthalten, um eine Übereinstimmung zu sein, was mit <a href="SetTitleMatchMode.htm">SetTitleMatchMode</a> geändert werden kann.</p> </dd> <dt>Zeitlimit</dt> <dd> <p>Typ: <a href="../Concepts.htm#numbers">Integer</a> oder <a href="../Concepts.htm#numbers">Float</a></p> <p>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.</p> </dd> </dl> <h2 id="Return_Value">Rückgabewert</h2> <p>Typ: <a href="../Concepts.htm#numbers">Integer</a></p> <p>Diese Funktion gibt die <a href="../misc/WinTitle.htm#ahk_id">HWND-Nummer (eindeutige ID)</a> des gefundenen Fensters zurück, oder 0, wenn die Funktion das Zeitlimit überschritten hat.</p> <h2 id="Remarks">Bemerkungen</h2> <p>Die Funktion hört bereits auf zu warten, wenn ein passendes Fenster gefunden wird, und nicht erst, wenn <em>Zeitlimit</em> abgelaufen ist. In diesem Fall wird das <a href="../misc/WinTitle.htm#LastFoundWindow">Zuletzt Gefundene Fenster</a> aktualisiert und die Skriptausführung fortgesetzt.</p> <p>Wenn <em>FensterTitel</em> eine <a href="../misc/WinTitle.htm#ahk_id">reine HWND-Nummer</a> ist (als <a href="../Concepts.htm#numbers">Integer</a> oder <a href="../Objects.htm">Objekt</a> mit einer HWND-Eigenschaft), werden versteckte Fenster nur erkannt, wenn <a href="DetectHiddenWindows.htm">DetectHiddenWindows</a> verwendet wird. Dies gilt nur für WinWait und <a href="WinWaitClose.htm">WinWaitClose</a>; bei anderen fensterspezifischen Funktionen bewirkt die Angabe einer reinen HWND-Nummer, dass versteckte Fenster immer erkannt werden, unabhängig von DetectHiddenWindows.</p> <p>Wenn <em>FensterTitel</em> eine ungültige reine HWND-Nummer ist, kehrt die Funktion sofort zurück, unabhängig von <em>Zeitlimit</em>. Zu warten, bis ein anderes Fenster mit derselben HWND-Nummer erstellt wird, wäre nicht sinnvoll, da die Chance hoch ist, dass beide Fenster nichts miteinander zu tun haben.</p> <p>Während die Funktion wartet, können neue <a href="../misc/Threads.htm">Threads</a> via <a href="../Hotkeys.htm">Hotkeys</a>, <a href="Menu.htm">benutzerdefinierte Menüpunkte</a> oder <a href="SetTimer.htm">Timer</a> gestartet werden.</p> <p>Wenn ein anderer <a href="../misc/Threads.htm">Thread</a> 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.</p> <p>Im Gegensatz zu <a href="WinWaitActive.htm">WinWaitActive</a> kann hier nicht das <a href="../misc/WinTitle.htm#LastFoundWindow">Zuletzt Gefundene Fenster</a> verwendet werden. Daher muss mindestens einer der Fensterparameter (<em>FensterTitel</em>, <em>FensterText</em>, <em>AusnahmeTitel</em>, <em>AusnahmeText</em>) einen nicht-leeren Wert enthalten.</p> <h2 id="Related">Siehe auch</h2> <p><a href="WinWaitActive.htm">WinWaitActive</a>, <a href="WinWaitClose.htm">WinWaitClose</a>, <a href="WinExist.htm">WinExist</a>, <a href="WinActive.htm">WinActive</a>, <a href="ProcessWait.htm">ProcessWait</a>, <a href="SetTitleMatchMode.htm">SetTitleMatchMode</a>, <a href="DetectHiddenWindows.htm">DetectHiddenWindows</a></p> <h2 id="Examples">Beispiele</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> Öffnet Notepad und wartet maximal 3 Sekunden, bis es existiert. Wenn WinWait das Zeitlimit überschreitet, wird eine Fehlermeldung angezeigt, andernfalls wird Notepad minimiert.</p> <pre>Run "notepad.exe" if WinWait("Unbenannt - Editor", , 3) WinMinimize <em>; Verwendet das von WinWait gefundene Fenster.</em> else MsgBox "WinWait hat das Zeitlimit überschritten." </pre> </div> </body> </html>