Función AdjustWindowRect (winuser.h)

Artículo
08/27/2023

Calcula el tamaño necesario del rectángulo de ventana, en función del tamaño deseado del rectángulo de cliente. A continuación, el rectángulo de ventana se puede pasar a la función CreateWindow para crear una ventana cuyo área de cliente sea el tamaño deseado.

Para especificar un estilo de ventana extendido, use la función AdjustWindowRectEx .

Sintaxis

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

Parámetros

[in, out] lpRect

Tipo: LPRECT

Puntero a una estructura RECT que contiene las coordenadas de las esquinas superior izquierda e inferior derecha del área de cliente deseada. Cuando la función devuelve, la estructura contiene las coordenadas de las esquinas superior izquierda e inferior derecha de la ventana para acomodar el área de cliente deseada.

[in] dwStyle

Tipo: DWORD

Estilo de ventana de la ventana cuyo tamaño necesario se va a calcular. Tenga en cuenta que no puede especificar el estilo WS_OVERLAPPED .

[in] bMenu

Tipo: BOOL

Indica si la ventana tiene un menú.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Un rectángulo de cliente es el rectángulo más pequeño que incluye completamente un área de cliente. Un rectángulo de ventana es el rectángulo más pequeño que incluye completamente la ventana, que incluye el área cliente y el área no cliente.

La función AdjustWindowRect no agrega espacio adicional cuando una barra de menús se ajusta a dos o más filas.

La función AdjustWindowRect no tiene en cuenta los estilos WS_VSCROLL ni WS_HSCROLL . Para tener en cuenta las barras de desplazamiento, llame a la función GetSystemMetrics con SM_CXVSCROLL o SM_CYHSCROLL.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-4 (introducido en Windows 10, versión 10.0.14393)