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
);
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.
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.
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.
Painting and Drawing Overview, Painting and Drawing Functions, RECT