DrawCaption

The DrawCaption function draws a window caption.

BOOL WINAPI DrawCaption(
  HWND hwnd,    // handle to window to get text and icon from
  HDC hdc,      // handle to device context to draw into
  LPCRECT lprc, // pointer to rectangle to draw into
  UINT uFlags,  // set of drawing option flags
);
 

Parameters

hwnd

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

hdc

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

lprc

Pointer to a RECT structure that specifies the bounding rectangle for the window caption.

uFlags

A set of bit flags that specify drawing options. You can set zero or more of the following flags:

Value	Meaning
DC_ACTIVE	The function uses the colors that denote an active caption.
DC_GRADIENT	Windows 98, Windows NT 5.0 and later: 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.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Windows NT: To get extended error information, call GetLastError.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in winuser.h.
  Import Library: Use user32.lib.

See Also

Painting and Drawing Overview, Painting and Drawing Functions, RECT