CDC::DrawFrameControl
BOOL DrawFrameControl( LPRECT lpRect**, UINT** nType**, UINT** nState );
Return Value
Nonzero if successful; otherwise 0.
Parameters
lpRect
A pointer to a RECT structure that contains the logical coordinates of the rectangle.
nType
Specifies the type of frame control to draw. This parameter can be one of the following values:
DFC_BUTTON Standard button
DFC_CAPTION Title bar
DFC_MENU Menu
DFC_SCROLL Scroll bar
nState
Specifies the initial state of the frame control. See the Remarks section for a table of the parameter’s values:
Remarks
Call this member function to draw a frame control of the specified type and style.
Use the nState value DFCS_ADJUSTRECT to adjust the bounding rectangle 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:
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.
In several cases, nState depends on the nType parameter. The following list shows the relationship between the four nType values and nState:
- DFC_BUTTON
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)
- DFC_CAPTION
DFCS_CAPTIONCLOSE Close button
DFCS_CAPTIONHELP Help button
DFCS_CAPTIONMAX Maximize button
DFCS_CAPTIONMIN Minimize button
DFCS_CAPTIONRESTORE Restore button
- DFC_MENU
DFCS_MENUARROW Submenu arrow
DFCS_MENUBULLET Bullet
DFCS_MENUCHECK Check mark
- DFC_SCROLL
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
For more information about the Windows API DrawFrameControl, see in the Win32 SDK Programmer’s Reference.
Example
This code draws the size gripper in the bottom-right corner of your window. It's appropriate for the OnPaint handler of a dialog box, which has no styles and normally doesn't contain other controls (like a status bar) that may give it a size gripper.
CRect rc;
GetClientRect(&rc);
rc.left = rc.right - ::GetSystemMetrics(SM_CXHSCROLL);
rc.top = rc.bottom - ::GetSystemMetrics(SM_CYVSCROLL);
dc.DrawFrameControl(rc, DFC_SCROLL, DFCS_SCROLLSIZEGRIP);