DrawFrameControl (Windows Embedded CE 6.0)

1/6/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

See Also

Reference

GDI Functions
BitBlt
MaskBlt
RECT