Função AdjustWindowRectEx (winuser.h)
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) |
Confira também
Conceitual
Outros recursos
Referência