DrawFrameControl
A version of this page is also available for
4/8/2010
This function draws a frame control of the specified type and style.
Syntax
BOOL DrawFrameControl(
HDC hdc,
LPRECT lprc,
UINT uType,
UINT uState
);
Parameters
- hdc
Handle to the device context of the window in which to draw the control.
- lprc
Long pointer to a RECT structure that contains the logical coordinates of the bounding rectangle for frame control.
uType
Specifies the type of frame control to draw.This parameter can be one of the following values.
Value Description DFC_BUTTON
Standard button
DFC_CAPTION
Title bar
DFC_SCROLL
Scroll bar
uState
Specifies the initial state of the frame control.If uType is DFC_BUTTON, uState can be one of the following values.
Value Description DFCS_BUTTON3STATE
Three-state button
DFCS_BUTTONCHECK
Check box
DFCS_BUTTONPUSH
Push button
DFCS_BUTTONRADIO
Radio button
If uType is DFC_CAPTION, uState can be one of the following values.
Value Description DFCS_CAPTIONCLOSE
Close button
DFCS_CAPTIONHELP
Help button
DFCS_CAPTIONOKBTN
OK button
If uType is DFC_SCROLL, uState can be one of the following values.
Value Description DFCS_SCROLLCOMBOBOX
Combo box scroll bar
DFCS_SCROLLDOWN
Down arrow of scroll bar
DFCS_SCROLLLEFT
Left arrow of scroll bar
DFCS_SCROLLRIGHT
Right arrow of scroll bar
DFCS_SCROLLUP
Up arrow of scroll bar
One or more of the following values can be used to set the state of the control to be drawn.
Value Description DFCS_CHECKED
The button is checked.
DFCS_INACTIVE
The button does not accept user input.
DFCS_PUSHED
The button is pushed.
Return Value
Nonzero indicates success.
Zero indicates failure.
To get extended error information, call GetLastError.
Remarks
If uType is DFC_BUTTON and uState is not DFCS_BUTTONPUSH, the frame control is a black-on-white mask (that is, a black frame control on a white background).
In such cases, the application must pass a handle to a bitmap memory device control. The application can then use the associated bitmap as the hbmMask parameter to the MaskBlt function, or it can use the device context as a parameter to the BitBlt function using ROPs such as SRCAND and SRCINVERT.
Requirements
| Header | winuser.h |
| Library | Nclient.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |