Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

DrawCaption function

The DrawCaption function draws a window caption.

Syntax


BOOL DrawCaption(
  _In_ HWND    hwnd,
  _In_ HDC     hdc,
  _In_ LPCRECT lprc,
  _In_ UINT    uFlags
);

Parameters

hwnd [in]

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

hdc [in]

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

lprc [in]

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

uFlags [in]

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

ValueMeaning
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]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Painting and Drawing Overview
Painting and Drawing Functions
RECT

 

 

Show: