Ξ
Δ
◄
►
¬
Ѕ
Filter
Direktiven
Interne Variablen
Interne Funktionen
Kontrollanweisungen
Operatoren
Deklarationen
Interne Klassen
Interne Methoden/Eigenschaften
Ahk2Exe-Compiler
Suchwörter hervorheben
<script src="../static/ga4.js" type="text/javascript"></script> </head> <body> <h1>WinGetPos</h1> <p>Ruft die Position und Größe eines bestimmten Fensters ab.</p> <pre class="Syntax"><span class="func">WinGetPos</span> <span class="optional">&AusX, &AusY, &AusBreite, &AusHöhe, FensterTitel, FensterText, AusnahmeTitel, AusnahmeText</span></pre> <h2 id="Parameters">Parameter</h2> <dl> <dt>&AusX, &AusY</dt> <dd> <p>Typ: <a href="../Concepts.htm#variable-references">VarRef</a></p> <p>Wenn weggelassen, wird der zugehörige Wert nicht gespeichert. Andernfalls geben Sie Referenzen an, die auf Ausgabevariablen verweisen, in denen die X- und Y-Koordinate der oberen linken Ecke des Zielfensters gespeichert werden sollen.</p> </dd> <dt>&AusBreite, &AusHöhe</dt> <dd> <p>Typ: <a href="../Concepts.htm#variable-references">VarRef</a></p> <p>Wenn weggelassen, wird der zugehörige Wert nicht gespeichert. Andernfalls geben Sie Referenzen an, die auf Ausgabevariablen verweisen, in denen die Breite und Höhe des Zielfensters gespeichert werden sollen.</p> </dd> <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>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; wenn jedoch <a href="../misc/WinTitle.htm#ahk_id">reine HWND-Nummern</a> verwendet werden, werden versteckte Fenster immer erkannt, unabhängig von DetectHiddenWindows. 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> </dl> <h2 id="Error_Handling">Fehlerbehandlung</h2> <p>Es wird ein <a href="Error.htm#TargetError">TargetError</a> ausgelöst, wenn das Fenster nicht gefunden werden konnte.</p> <h2 id="Remarks">Bemerkungen</h2> <p>Wenn <em>FensterTitel</em> <code>"Program Manager"</code> ist, wird die Größe des Desktops abgerufen, was meist der aktuellen Bildschirmauflösung entspricht.</p> <p>Ein minimiertes Fenster hat immer noch eine Position und Größe. Die Werte, die in diesem Fall zurückgegeben werden, können je nach Betriebssystem und Konfiguration variieren, sind aber in der Regel -32000 für die X- und Y-Koordinate und 0 für die Breite und Höhe.</p> <p>Mit <a href="MouseGetPos.htm">MouseGetPos</a> kann der Name des Fensters und des Steuerelements unter dem Mauszeiger abgerufen werden.</p> <p>Da die Koordinaten, die von dieser Funktion zurückgegeben werden, auch die Titelleiste, die Menüleiste und den Rahmen des Fensters einbeziehen, können sie je nach Version und Design des Betriebssystems variieren. Um konsistentere Werte auf verschiedenen Systemen zu erhalten, sollten Sie stattdessen <a href="WinGetClientPos.htm">WinGetClientPos</a> verwenden.</p> <p>Auf Systemen mit mehreren Bildschirmen, die unterschiedliche DPI-Einstellungen haben, kann die zurückgegebene Position und Größe aufgrund der <a href="../misc/DPIScaling.htm">OS-DPI-Skalierung</a> anders ausfallen als erwartet.</p> <h2 id="Related">Siehe auch</h2> <p><a href="WinMove.htm">WinMove</a>, <a href="WinGetClientPos.htm">WinGetClientPos</a>, <a href="ControlGetPos.htm">ControlGetPos</a>, <a href="WinGetTitle.htm">WinGetTitle</a>, <a href="WinGetText.htm">WinGetText</a>, <a href="ControlGetText.htm">ControlGetText</a></p> <h2 id="Examples">Beispiele</h2> <div class="ex" id="ExBasic"> <p><a class="ex_number" href="#ExBasic"></a> Ermittelt und meldet die Position und Größe des Taschenrechners.</p> <pre>WinGetPos &X, &Y, &W, &H, "Rechner" MsgBox "Der Rechner befindet sich auf " X "," Y " und hat die Größe " W "x" H</pre> </div> <div class="ex" id="ExA"> <p><a class="ex_number" href="#ExA"></a> Ermittelt und meldet die Position des aktiven Fensters.</p> <pre>WinGetPos &X, &Y,,, "A" MsgBox "Das aktive Fenster befindet sich auf " X "," Y</pre> </div> <div class="ex" id="ExLastFound"> <p><a class="ex_number" href="#ExLastFound"></a> Wenn Notepad existiert, seine Position abrufen und melden.</p> <pre>if WinExist("Unbenannt - Editor") { WinGetPos &Xpos, &Ypos <em>; Verwendet das von WinExist gefundene Fenster.</em> MsgBox "Notepad befindet sich auf " Xpos "," Ypos }</pre> </div> </body> </html>