Función DrawCaption (winuser.h)

La función DrawCaption dibuja una ventana subtítulo.

Sintaxis

BOOL DrawCaption(
  [in] HWND       hwnd,
  [in] HDC        hdc,
  [in] const RECT *lprect,
  [in] UINT       flags
);

Parámetros

[in] hwnd

Identificador de una ventana que proporciona texto y un icono para la ventana subtítulo.

[in] hdc

Identificador de un contexto de dispositivo. La función dibuja el título de la ventana en este contexto de dispositivo.

[in] lprect

Puntero a una estructura RECT que especifica el rectángulo delimitador de la ventana subtítulo en coordenadas lógicas.

[in] flags

Opciones de dibujo. Este parámetro puede ser cero o más de los siguientes valores.

Valor Significado
DC_ACTIVE
La función usa los colores que indican un subtítulo activo.
DC_BUTTONS
Si se establece, la función dibuja los botones de la barra de subtítulo (para minimizar, restaurar o cerrar una aplicación).
DC_GRADIENT
Cuando se establece esta marca, la función usa COLOR_GRADIENTACTIVECAPTION (si se estableció la marca DC_ACTIVE) o COLOR_GRADIENTINACTIVECAPTION para el color de la barra de título.

Si no se establece esta marca, la función usa COLOR_ACTIVECAPTION o COLOR_INACTIVECAPTION para ambos colores.

DC_ICON
La función dibuja el icono al dibujar el texto subtítulo.
DC_INBUTTON
La función dibuja el subtítulo como un botón.
DC_SMALLCAP
La función dibuja un pequeño subtítulo, utilizando la fuente subtítulo pequeña actual.
DC_TEXT
La función dibuja el texto subtítulo al dibujar el subtítulo.
 

Si se especifica DC_SMALLCAP, la función dibuja una ventana normal subtítulo.

Valor devuelto

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.

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

Consulte también

Funciones de dibujo y pintura

Información general sobre la pintura y el dibujo

RECT