winuser.h


AdjustWindowRect

La función AdjustWindowRect calcula el tamaño necesario del rectángulo de una ventana a partir del tamaño deseado del rectángulo del área de cliente. El rectángulo de la ventana se puede usar en la función CreateWindowEx para crear una ventana cuyo área de cliente tendrá el tamaño deseado.

Sintaxis

BOOL AdjustWindowRect(
    LPRECT lpRect,  // puntero a estructura con rectángulo de área de cliente
    DWORD dwStyle,  // estilos de la ventana
    BOOL bMenu 	    // bandera de presencia de menú
   );

Parámetros

lpRect: puntero a una estructura RECT que contiene las coordenadas de las esquinas superior izquierda e inferior derecha del área de cliente deseada. Cunado la función regresa, la estructura contiene las coordenadas de las esquinas superior izquierda e inferior derecha de la ventana que contiene el área de cliente deseada.

dwStyle: especifica los estilos de ventana de la ventana cuyo tamaño de está calculando.

bMenu: especifica si la ventana tiene un menú.

Valor de retorno

Si la función tiene éxito, el valor de retorno será distinto de cero.

Si la función falla, el valor de retorno es cero. Para obtener información complementaria sobre el error, llamar a GetLastError.

Observaciones

Un rectángulo de cliente es el rectángulo más pequeño que contiene por completo un área de cliente. Un rectángulo de ventana es el rectángulo más pequeño que contiene por completo a una ventana.

La función AdjustWindowRect no añade espacio extra cuando una barra de menú ocupa dos o más filas.