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