Compartilhar via


Função GetClientRect (winuser.h)

Recupera as coordenadas da área de cliente de uma janela. As coordenadas do cliente especificam os cantos superior esquerdo e inferior direito da área do cliente. Como as coordenadas do cliente são relativas ao canto superior esquerdo da área do cliente de uma janela, as coordenadas do canto superior esquerdo são (0,0).

Sintaxe

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

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela cujas coordenadas do cliente devem ser recuperadas.

[out] lpRect

Tipo: LPRECT

Um ponteiro para uma estrutura RECT que recebe as coordenadas do cliente. Os membros esquerdo e superior são zero. Os membros direito e inferior contêm a largura e a altura da janela.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Em conformidade com as convenções para a estrutura RECT , as coordenadas inferior direita do retângulo retornado são exclusivas. Em outras palavras, o pixel em (direita, inferior) fica imediatamente fora do retângulo.

Exemplos

Por exemplo, consulte Criando, enumerando e dimensionando janelas filho.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-window-l1-1-0 (introduzido no Windows 8)

Confira também

Conceitual

Getwindowrect

Outros recursos

RECT

Referência

Windows