GetWindowRect-Funktion (winuser.h)

Artikel
08/27/2023

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)