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 ::DrawFrameControl 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);

CDC Overview |  Class Members |  Hierarchy Chart

See Also   ::DrawFrameControl