GetClientRect-Funktion (winuser.h)

Ruft die Koordinaten des Clientbereichs eines Fensters ab. Die Clientkoordinaten geben die oberen linken und unteren rechten Ecken des Clientbereichs an. Da clientkoordinaten relativ zur oberen linken Ecke des Clientbereichs eines Fensters sind, sind die Koordinaten der linken oberen Ecke (0,0).

Syntax

BOOL GetClientRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das Fenster, dessen Clientkoordinaten abgerufen werden sollen.

[out] lpRect

Typ: LPRECT

Ein Zeiger auf eine RECT-Struktur , die die Clientkoordinaten empfängt. Die linken und oberen Elemente sind null. Die rechten und unteren Member enthalten die Breite und Höhe des Fensters.

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

Gemäß den Konventionen für die RECT-Struktur sind die koordinaten unten rechts des zurückgegebenen Rechtecks exklusiv. Mit anderen Worten, das Pixel an (rechts, unten) liegt direkt außerhalb des Rechtecks.

Beispiele

Weitere Informationen finden Sie z. B. unter Erstellen, Aufzählen und Größenanpassung untergeordneter Windows-Fenster.

Anforderungen

Anforderung Wert
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 (einschließlich Windows.h)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8)

Siehe auch

Konzept

GetWindowRect

Andere Ressourcen

RECT

Referenz

Windows