Função GetWindowRect (winuser.h)

Artigo
08/27/2023

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


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)