The DrawFrameControl function draws a frame control of the specified type and style.
BOOL DrawFrameControl(
HDC hdc, | // handle to device context |
LPRECT lprc, | // pointer to bounding rectangle |
UINT uType, | // frame-control type |
UINT uState | // frame-control state |
); |
Parameters
hdc
Identifies the device context of the window in which to draw the control.
lprc
Points 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 | Meaning |
DFC_BUTTON | Standard button |
DFC_CAPTION | Title bar |
DCF_MENU | Menu |
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 | Meaning |
DFCS_BUTTON3STATE | Three-state button |
DFCS_BUTTONCHECK | Check box |
DFCS_BUTTONPUSH | Push button |
DFCS_BUTTONRADIO | Radio button |
DFCS_BUTTONRADIOIMAGE | Image for radio button (nonsquare needs image) |
DFCS_BUTTONRADIOMASK | Mask for radio button (nonsquare needs mask) |
If uType is DFC_CAPTION, uState can be one of the following values:
Value | Meaning |
DFCS_CAPTIONCLOSE | Close button |
DFCS_CAPTIONHELP | Windows 95 only: Help button |
DFCS_CAPTIONMAX | Maximize button |
DFCS_CAPTIONMIN | Minimize button |
DFCS_CAPTIONRESTORE | Restore button |
If uType is DFC_MENU, uState can be one of the following values:
Value | Meaning |
DFCS_MENUARROW | Submenu arrow |
DFCS_MENUBULLET | Bullet |
DFCS_MENUCHECK | Check mark |
If uType is DFC_SCROLL, uState can be one of the following values:
Value | Meaning |
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_SCROLLSIZEGRIP | Size grip in bottom-right corner of window |
DFCS_SCROLLUP | Up arrow of scroll bar |
The following style can be used to adjust the bounding rectangle of the push button:
Value | Meaning |
DFCS_ADJUSTRECT | Bounding rectangle is adjusted to exclude the surrounding edge of the push button. |
One or more of the following values can be used to set the state of the control to be drawn:
Value | Meaning |
DFCS_CHECKED | Button is checked. |
DFCS_FLAT | Button has a flat border. |
DFCS_INACTIVE | Button is inactive (grayed). |
DFCS_MONO | Button has a monochrome border. |
DFCS_PUSHED | Button is pushed. |
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
See Also