Funzione GetClientRect (winuser.h)

  • Articolo

Recupera le coordinate dell'area client di una finestra. Le coordinate client specificano gli angoli superiore sinistro e inferiore destro dell'area client. Poiché le coordinate client sono relative all'angolo superiore sinistro dell'area client di una finestra, le coordinate dell'angolo superiore sinistro sono (0,0).

Sintassi

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

Parametri

[in] hWnd

Tipo: HWND

Handle della finestra le cui coordinate client devono essere recuperate.

[out] lpRect

Tipo: LPRECT

Puntatore a una struttura RECT che riceve le coordinate client. I membri sinistro e superiore sono zero. I membri destro e inferiore contengono la larghezza e l'altezza della finestra.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

In conformità alle convenzioni per la struttura RECT , le coordinate in basso a destra del rettangolo restituito sono esclusive. In altre parole, il pixel in corrispondenza (destra, inferiore) si trova immediatamente all'esterno del rettangolo.

Esempio

Ad esempio, vedere Creazione, enumerazione e ridimensionamento delle finestre figlio.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winuser.h (include Windows.h)
Libreria User32.lib
DLL User32.dll
Set di API ext-ms-win-ntuser-window-l1-1-0 (introdotto in Windows 8)

Vedi anche

Informazioni concettuali

GetWindowRect

Altre risorse

RECT

Riferimento

Windows