Función AdjustWindowRectEx (winuser.h)

Artículo
03/15/2023

Calcula el tamaño necesario del rectángulo de la 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 CreateWindowEx para crear una ventana cuyo área de cliente sea el tamaño deseado.

Sintaxis

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

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ú.

[in] dwExStyle

Tipo: DWORD

Estilo de ventana extendida de la ventana cuyo tamaño necesario se va a calcular.

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 AdjustWindowRectEx no agrega espacio adicional cuando una barra de menús se ajusta a dos o más filas.

La función AdjustWindowRectEx 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.

Esta API no es compatible con PPP y no debe usarse si el subproceso de llamada es compatible con PPP por monitor. Para obtener la versión compatible con PPP de esta API, consulte AdjustWindowsRectExForDPI. Para obtener más información sobre el reconocimiento de PPP, consulte la documentación de Valores altos de PPP de Windows.

Requisitos

Requisito	Value
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-0 (introducido en Windows 8)