Share via


NonClientView_t::DrawFrameControl

Other versions of this page are also available for the following:

Windows Mobile Not SupportedWindows Embedded CE Supported

8/28/2008

This method draws a frame control of the specified type and style.

Syntax

static BOOL DrawFrameControl(
  HDC hdc,
  RECT* lprc,
  UINT wType,
  UINT wState
);

Parameters

  • hdc
    [in] Handle to the device context for the window.
  • lprc
    [in] Pointer to a RECT structure that specifies the coordinates of the bounding rectangle for the window.
  • wType
    [in] Unsigned integer that specifies the type of control to draw. The following table shows the possible values.

    Value Description

    DFC_BUTTON

    Draws a standard button.

    DFC_CAPTION

    Draws a title bar.

    DFC_MENU

    Draws a menu.

    DFC_SCROLL

    Draws a scroll bar.

  • wState
    [in] Unsigned integer that specifies the state of the control.

    The following table shows the possible values, if wType is DFC_BUTTON.

    Value Description

    DFCS_BUTTON3STATE

    A three-state button.

    DFCS_BUTTONCHECK

    A check box.

    DFCS_BUTTONPUSH

    A push button.

    DFCS_BUTTONRADIO

    A radio button.

    DFCS_BUTTONRADIOIMAGE

    An image for a radio button.

    DFCS_BUTTONRADIOMASK

    A mask for a radio button.

    The following table shows the possible values, if wType is DFC_CAPTION.

    Value Description

    DFCS_CAPTIONCLOSE

    A Close (X) button.

    DFCS_CAPTIONHELP

    A Help button.

    DFCS_CAPTIONMAX

    A Maximize button.

    DFCS_CAPTIONMIN

    A Minimize button.

    DFCS_CAPTIONOKBUTTON

    An OK button.

    DFCS_CAPTIONRESTORE

    A Restore button.

    The following table shows the possible values, if wType is DFC_SCROLL.

    Value Description

    DFCS_SCROLLCOMBOBOX

    The combo box scroll box.

    DFCS_SCROLLDOWN

    The scroll bar contains a down arrow.

    DFCS_SCROLLLEFT

    The scroll bar contains a left arrow.

    DFCS_SCROLLRIGHT

    The scroll bar contains a right arrow.

    DFCS_SCROLLSIZEGRIP

    The status bar.

    DFCS_SCROLLUP

    The scroll bar contains an up arrow.

    The following table shows the possible values that do not depend on the value of wState.

    Value Description

    DFCS_ADJUSTRECT

    The bounding rectangle is adjusted to leave space for the client area.

    DFCS_FLAT

    The button has a flat border.

    DFCS_FOREGROUND

    The button is in the foreground.

    DFCS_MONO

    The button has a monochrome border.

    DFCS_INACTIVE

    The button does not accept user input.

    DFCS_PUSHED

    The button is pressed.

    DFCS_CHECKED

    The button is checked.

Return Value

TRUE indicates success. FALSE indicates failure.

Requirements

Header nclientview.hpp
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

NonClientView_t::ExposedDrawFrameControl
RECT