WinGetPos
Beschreibung anzeigen in
Ermittelt die Position und die Größe eines Fensters.
WinGetPos ( "title" [, "text"] )
Parameter
| title | Der Titel, das Handle oder die Klasse des Fensters, dessen Position/Größe erhalten werden soll. Siehe Erweiterte Fenstertiteldefinition. |
| text | [optional] Der Text des Fensters, dessen Position/Größe erhalten werden soll. Standardwert ist ein Leerstring. Siehe Erweiterte Fenstertextdefinition. |
Rückgabewert
| Erfolg: | ein Array mit 4 Elementen und folgenden Informationen: $aArray[0] = X-Position $aArray[1] = Y-Position $aArray[2] = Breite $aArray[3] = Höhe |
| Fehler: | Setzt das @error Flag auf ungleich null, wenn das Fenster nicht gefunden wurde. |
Bemerkungen
WinGetPos() gibt eine negative Zahl (z.B. -32000) für ein minimiertes Fenster zurück, arbeitet aber einwandfrei mit (nicht minimierten) versteckten Fenstern.
Wenn der Fenstertitel "Program Manager" angegeben wird, gibt die Funktion die Größe des Desktops zurück. Falls mehrere Fenster das angegebene Kriterium erfüllen, wird das zuletzt aktive Fenster verwendet.
Verwandte Funktionen
WinGetClientSize, WinGetState, WinMove
Beispiel
#include <MsgBoxConstants.au3>
Example()
Func Example()
; Ermittelt die Position als auch die Höhe und Breite des aktiven Fensters.
Local $aPos = WinGetPos("[ACTIVE]")
; Zeigt die Arraywerte die durch WinGetPos zurückgegeben wurden.
MsgBox($MB_SYSTEMMODAL, "", "X-Pos: " & $aPos[0] & @CRLF & _
"Y-Pos: " & $aPos[1] & @CRLF & _
"Breite: " & $aPos[2] & @CRLF & _
"Höhe: " & $aPos[3])
EndFunc ;==>Example