DrawCaption function (winuser.h)

The DrawCaption function draws a window caption.

Syntax

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

[in] hwnd

A handle to a window that supplies text and an icon for the window caption.

[in] hdc

A handle to a device context. The function draws the window caption into this device context.

[in] lprect

A pointer to a RECT structure that specifies the bounding rectangle for the window caption in logical coordinates.

[in] flags

The drawing options. This parameter can be zero or more of the following values.

Value	Meaning
DC_ACTIVE	The function uses the colors that denote an active caption.
DC_BUTTONS	If set, the function draws the buttons in the caption bar (to minimize, restore, or close an application).
DC_GRADIENT	When this flag is set, the function uses COLOR_GRADIENTACTIVECAPTION (if the DC_ACTIVE flag was set) or COLOR_GRADIENTINACTIVECAPTION for the title-bar color. If this flag is not set, the function uses COLOR_ACTIVECAPTION or COLOR_INACTIVECAPTION for both colors.
DC_ICON	The function draws the icon when drawing the caption text.
DC_INBUTTON	The function draws the caption as a button.
DC_SMALLCAP	The function draws a small caption, using the current small caption font.
DC_TEXT	The function draws the caption text when drawing the caption.

If DC_SMALLCAP is specified, the function draws a normal window caption.

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	winuser.h (include Windows.h)
Library	User32.lib
DLL	User32.dll

Was this page helpful?