DrawCaption function

The DrawCaption function draws a window caption.

Syntax

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

Parameters

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.

Return Value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Requirements

   
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

See Also

Painting and Drawing Functions

Painting and Drawing Overview

RECT