Função AdjustWindowRectEx (winuser.h)

Artigo
08/27/2023

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

Sintaxe

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

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.

[in] dwExStyle

Tipo: DWORD

O estilo de janela estendida da janela cujo tamanho necessário deve ser calculado.

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

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 AdjustWindowRectEx não adiciona espaço extra quando uma barra de menus é encapsulada em duas ou mais linhas.

A função AdjustWindowRectEx 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.

Essa API não tem reconhecimento de DPI e não deve ser usada se o thread de chamada estiver ciente da DPI por monitor. Para obter a versão com reconhecimento de DPI dessa API, consulte AdjustWindowsRectExForDPI. Para obter mais informações sobre o reconhecimento de DPI, consulte a documentação do Windows High DPI.

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 em Windows 8)