Ξ
Δ
◄
►
¬
Ѕ
Filter
Direktiven
Interne Variablen
Interne Funktionen
Kontrollanweisungen
Operatoren
Deklarationen
Befehle
Unterbefehle
Interne Methoden/Eigenschaften
Ahk2Exe-Compiler
Suchwörter hervorheben
<script src="../static/ga4.js" type="text/javascript"></script> </head> <body> <h1>WinClose</h1> <p>Schließt ein bestimmtes Fenster.</p> <pre class="Syntax"><span class="func">WinClose</span> <span class="optional">, FensterTitel, FensterText, Wartezeit, AusnahmeTitel, AusnahmeText</span></pre> <h2 id="Parameters">Parameter</h2> <dl> <dt>FensterTitel, FensterText, AusnahmeTitel, AusnahmeText</dt> <dd> <p>Wenn jeder dieser Parameter leer ist oder weggelassen wird, wird das <a href="../misc/WinTitle.htm#LastFoundWindow">Zuletzt Gefundene Fenster</a> verwendet. Andernfalls 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 muss ein Fenstertitel mit dem angegebenen <em>FensterTitel</em> oder <em>AusnahmeTitel</em> beginnen, um eine Übereinstimmung zu sein, was mit <a href="SetTitleMatchMode.htm">SetTitleMatchMode</a> geändert werden kann.</p> </dd> <dt>Wartezeit</dt> <dd> <p>Wenn leer oder weggelassen, wird der Befehl überhaupt nicht warten. Wenn 0, gilt eine Wartezeit von 500 ms. Andernfalls geben Sie die maximale Wartezeit in Sekunden an (kann einen Dezimalpunkt enthalten oder ein <a href="../Variables.htm#Expressions">Ausdruck</a> sein). Schließt sich das Fenster nicht innerhalb dieser Zeit, wird das Skript fortgesetzt.</p> </dd> </dl> <h2 id="Remarks">Bemerkungen</h2> <p>Dieser Befehl sendet eine Schließmeldung an das Fenster. Das Ergebnis hängt vom Fenster ab (es könnte fragen, ob die Daten gespeichert werden sollen, und so weiter).</p> <p>Wenn ein übereinstimmendes Fenster aktiv ist, wird dieses Fenster vorrangig vor allen anderen übereinstimmenden Fenstern geschlossen. Bei mehreren übereinstimmenden Fenstern wird in der Regel das oberste (zuletzt verwendete) Fenster geschlossen.</p> <p>Dieser Befehl arbeitet nur mit einem Fenster, es sei denn, <em>FensterTitel</em> ist <a href="GroupAdd.htm">ahk_group GruppeName</a> (ohne Angabe weiterer Kriterien), dann sind alle Fenster in der Gruppe betroffen.</p> <p><a href="../misc/ErrorLevel.htm">ErrorLevel</a> wird von diesem Befehl <u>nicht</u> gesetzt. Verwenden Sie daher <a href="WinExist.htm">WinExist()</a>, <a href="IfWinExist.htm">IfWinExist</a> oder <a href="WinWaitClose.htm">WinWaitClose</a>, um festzustellen, ob ein Fenster tatsächlich geschlossen ist.</p> <p>Während der Befehl 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>WinClose sendet eine WM_CLOSE-Meldung an das Zielfenster, was eine etwas gewaltsame Methode zum Schließen des Fensters ist. Eine alternative Schließmethode ist das Senden der folgenden Meldung. Beachten Sie jedoch, dass sich das Fenster möglicherweise anders verhält, da der Effekt dem Drücken von <kbd>Alt</kbd>+<kbd>F4</kbd> oder dem Klicken auf die Schließen-Schaltfläche in der Titelleiste ähnelt:</p> <pre>PostMessage, 0x0112, 0xF060,,, FensterTitel, FensterText <em>; 0x0112 = WM_SYSCOMMAND, 0xF060 = SC_CLOSE</em></pre> <p>Lässt sich ein Fenster nicht mit WinClose schließen, kann die Schließung mit <a href="WinKill.htm">WinKill</a> erzwungen werden.</p> <h2 id="Related">Siehe auch</h2> <p><a href="WinKill.htm">WinKill</a>, <a href="WinWaitClose.htm">WinWaitClose</a>, <a href="Process.htm">Process</a>, <a href="WinActivate.htm">WinActivate</a>, <a href="SetTitleMatchMode.htm">SetTitleMatchMode</a>, <a href="DetectHiddenWindows.htm">DetectHiddenWindows</a>, <a href="../misc/WinTitle.htm#LastFoundWindow">Zuletzt Gefundenes Fenster</a>, <a href="WinExist.htm">WinExist()</a>, <a href="WinActive.htm">WinActive()</a>, <a href="WinWaitActive.htm">WinWaitActive</a>, <a href="WinWait.htm">WinWait</a>, <a href="GroupActivate.htm">GroupActivate</a></p> <h2 id="Examples">Beispiele</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> Wenn Notepad existiert, schließe es, andernfalls schließe den Taschenrechner.</p> <pre>if WinExist("Unbenannt - Editor") WinClose <em>; Verwendet das von WinExist gefundene Fenster.</em> else WinClose, Rechner</pre> </div> </body> </html>