GetWindowRect-Funktion (winuser.h)
Ruft die Dimensionen des umgebenden Rechtecks des angegebenen Fensters ab. Die Dimensionen werden in Bildschirmkoordinaten angegeben, die relativ zur oberen linken Ecke des Bildschirms sind.
Syntax
BOOL GetWindowRect(
[in] HWND hWnd,
[out] LPRECT lpRect
);
Parameter
[in] hWnd
Typ: HWND
Ein Handle für das Fenster.
[out] lpRect
Typ: LPRECT
Ein Zeiger auf eine RECT-Struktur , die die Bildschirmkoordinaten der oberen linken und unteren rechten Ecke des Fensters empfängt.
Rückgabewert
Typ: BOOL
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
In Übereinstimmung mit den Konventionen für die RECT-Struktur sind die unteren rechten Koordinaten des zurückgegebenen Rechtecks exklusiv. Anders ausgedrückt: Das Pixel an (rechts, unten) liegt direkt außerhalb des Rechtecks.
GetWindowRect wird für DPI virtualisiert.
In Windows Vista und höher enthält das Fensterrechteck jetzt den Bereich, der vom Schlagschatten belegt ist.
Der Aufruf von GetWindowRect weist je nachdem, ob das Fenster jemals angezeigt wurde oder nicht, ein anderes Verhalten auf. Wenn das Fenster noch nicht angezeigt wurde, enthält GetWindowRect nicht den Bereich des Schlagschattens.
Verwenden Sie DwmGetWindowAttribute, um die Fenstergrenzen mit Ausnahme des Schlagschattens abzurufen, und geben Sie DWMWA_EXTENDED_FRAME_BOUNDS an. Beachten Sie, dass im Gegensatz zum Fensterrekt die DWM-Erweiterten Framegrenzen nicht für DPI angepasst werden. Das Abrufen der erweiterten Framegrenzen kann nur erfolgen, nachdem das Fenster mindestens einmal angezeigt wurde.
Beispiele
Ein Beispiel finden Sie unter Initialisieren eines Dialogfelds.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winuser.h (windows.h einschließen) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
| APIs | ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8) |
Siehe auch
Konzept
Referenz