DrawCaption

Overview

Group

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
user32.lib
Header File
winuser.h
Unicode
No
Platform Notes
None

[Now Supported on Windows NT]

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_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.