DrawFrameControl function

The DrawFrameControl function draws a frame control of the specified type and style.

Syntax

BOOL DrawFrameControl(
  HDC    ,
  LPRECT ,
  UINT   ,
  UINT   
);

Parameters

arg1

A handle to the device context of the window in which to draw the control.

arg2

A pointer to a RECT structure that contains the logical coordinates of the bounding rectangle for frame control.

arg3

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
DFC_MENU
Menu bar
DFC_POPUPMENU
Popup menu item.
DFC_SCROLL
Scroll bar

arg4

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
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_MENUARROWRIGHT
Submenu arrow pointing left. This is used for the right-to-left cascading menus used with right-to-left languages such as Arabic or Hebrew.
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 lower-right corner of window
DFCS_SCROLLSIZEGRIPRIGHT
Size grip in lower-left corner of window. This is used with right-to-left languages such as Arabic or Hebrew.
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_HOT
Button is hot-tracked.
DFCS_INACTIVE
Button is inactive (grayed).
DFCS_MONO
Button has a monochrome border.
DFCS_PUSHED
Button is pushed.
DFCS_TRANSPARENT
The background remains untouched. This flag can only be combined with DFCS_MENUARROWUP or DFCS_MENUARROWDOWN.

Return Value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

If uType is either DFC_MENU or 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.

DPI Virtualization

This API does not participate in DPI virtualization. The input given is always in terms of physical pixels, and is not related to the calling context.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll

See Also

Painting and Drawing Functions

Painting and Drawing Overview

RECT