WinGetClientSize
Beschreibung anzeigen in
Ermittelt die Größe des Clientbereichs eines Fensters (Fenster ohne Titel, Status, Rahmen).
WinGetClientSize ( "title" [, "text"] )
Parameter
| title | Der Titel/Fenster-Handle(hWnd)/Klassenname(class) des Fensters, dessen Größe gelesen werden soll. Siehe Erweiterte Fenstertiteldefinition. |
| text | [optional] Der Text des Fensters, dessen Größe gelesen werden soll. Standardwert ist ein leerer String. Siehe Erweiterte Fenstertextdefinition. |
Rückgabewert
| Erfolg: | Array mit zwei Elementen und folgenden Inhalt: $aArray[0] = Breite des Fensters. $aArray[1] = Höhe des Fensters. |
| Fehler: | Setzt das @error Flag auf ungleich null, wenn das Fenster nicht gefunden wird. |
Bemerkungen
Ist das Fenster minimiert, sind Breite und Höhe '0'. WinGetClientSize() arbeitet allerdings korrekt 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 abgefragt.
Verwandte Funktionen
Beispiel
#include <MsgBoxConstants.au3>
Example()
Func Example()
; Startet den Editor
Run("notepad.exe")
; Wartet maximal 10 Sekunden bis das Editorfenster erscheint.
Local $hWnd = WinWait("[CLASS:Notepad]", "", 10)
; Ermittelt die Größe des Clientbereichs des Editorfensters durch die Verwendung des von WinWait zurückgegebenen Handles.
Local $aClientSize = WinGetClientSize($hWnd)
; Zeigt die Höhe und Breite des Clientbereichs an.
MsgBox($MB_SYSTEMMODAL, "", "Width: " & $aClientSize[0] & @CRLF & "Height: " & $aClientSize[1])
; Schließt das Editorfenster durch die Verwendung des von WinWait zurückgegebenen Handles.
WinClose($hWnd)
EndFunc ;==>Example