Função GetWindowRect (winuser.h)

Recupera as dimensões do retângulo delimitador da janela especificada. As dimensões são fornecidas em coordenadas de tela relativas ao canto superior esquerdo da tela.

Sintaxe

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

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela.

[out] lpRect

Tipo: LPRECT

Um ponteiro para uma estrutura RECT que recebe as coordenadas da tela dos cantos superior esquerdo e inferior direito da janela.

Valor retornado

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.

GetWindowRect é virtualizado para DPI.

No Windows Vista e posterior, o Window Rect agora inclui a área ocupada pela sombra.

Chamar GetWindowRect terá um comportamento diferente dependendo se a janela já foi mostrada ou não. Se a janela não tiver sido mostrada antes, GetWindowRect não incluirá a área da sombra.

Para obter os limites da janela, excluindo a sombra, use DwmGetWindowAttribute, especificando DWMWA_EXTENDED_FRAME_BOUNDS. Observe que, ao contrário do Window Rect, os Limites de Quadro Estendido dwm não são ajustados para DPI. A obtenção dos limites de quadro estendido só pode ser feita depois que a janela for mostrada pelo menos uma vez.

Exemplos

Para obter um exemplo, consulte Inicializando uma caixa de diálogo.

Requisitos

Confira também

Conceitual

GetClientRect

Referência

Screentoclient

Setwindowpos

Windows