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

Tipo: HWND

Um identificador para a janela.

[out] lpRect

Tipo: LPRECT

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

Valor de retorno

Tipo: BOOL

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

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

Observações

Em conformidade com as convenções da 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 pode incluir bordas de redimensionamento invisíveis.

Para obter os limites visíveis da janela, não incluindo as bordas de redimensionamento invisíveis, use DwmGetWindowAttribute, especificando DWMWA_EXTENDED_FRAME_BOUNDS. Observe que, ao contrário do Rect window, os limites de quadro estendido dwm não são ajustados para DPI.

Exemplos

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

Requisitos

Consulte também

Conceitual

GetClientRect

Referência

ScreenToClient

SetWindowPos

Windows