Função AdjustWindowRect (winuser.h)

Artigo
08/27/2023

Calcula o tamanho necessário do retângulo da janela, com base no tamanho do retângulo cliente-retângulo desejado. Em seguida, o retângulo da janela pode ser passado para a função CreateWindow para criar uma janela cuja área do cliente é o tamanho desejado.

Para especificar um estilo de janela estendido, use a função AdjustWindowRectEx .

Sintaxe

BOOL AdjustWindowRect(
  [in, out] LPRECT lpRect,
  [in]      DWORD  dwStyle,
  [in]      BOOL   bMenu
);

Parâmetros

[in, out] lpRect

Tipo: LPRECT

Um ponteiro para uma estrutura RECT que contém as coordenadas dos cantos superior esquerdo e inferior direito da área de cliente desejada. Quando a função retorna, a estrutura contém as coordenadas dos cantos superior esquerdo e inferior direito da janela para acomodar a área de cliente desejada.

[in] dwStyle

Tipo: DWORD

O estilo de janela da janela cujo tamanho necessário deve ser calculado. Observe que você não pode especificar o estilo WS_OVERLAPPED .

[in] bMenu

Tipo: BOOL

Indica se a janela tem um menu.

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

Um retângulo do cliente é o menor retângulo que inclui completamente uma área de cliente. Um retângulo de janela é o menor retângulo que inclui completamente a janela, que inclui a área do cliente e a área não cliente.

A função AdjustWindowRect não adiciona espaço extra quando uma barra de menus é encapsulada em duas ou mais linhas.

A função AdjustWindowRect não leva em conta os estilos WS_VSCROLL ou WS_HSCROLL . Para considerar as barras de rolagem, chame a função GetSystemMetrics com SM_CXVSCROLL ou SM_CYHSCROLL.

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-4 (introduzido no Windows 10, versão 10.0.14393)