DrawCaption function

The DrawCaption function draws a window caption.

Syntax

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

hwnd

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

hdc

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

lprect

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

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.


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