ButtonView_t::DrawText

  • Article

This method draws the text or focus rectangle of a button.

static void DrawText(
  HWND hwnd,
  HDC hdc,
  BOOL dbt,
  BOOL fDepress,
  UINT pbfPush,
  enum ButtonControlRectangleStyle_t bcrs,
  WORD alignment
);

Parameters

  • hwnd
    [in] Handle to a window.

  • hdc
    [in] Handle to a device context.

  • dbt
    [in] Boolean that specifies whether to draw the text or the focus rectangle of the button. DBT_TEXT indicates that ButtonView_t::DrawText should draw the text of the button. DBT_FOCUS indicates that ButtonView_t::DrawText should draw the focus rectangle of the button.

  • fDepress
    [in] Boolean that specifies whether the button should appear pressed. TRUE indicates that the button should appear pressed. FALSE indicates that the button should not appear pressed.

  • pbfPush
    [in] Unsigned integer that describes whether a button can be pressed. The following table shows the possible values.

    Value Description
    PBF_DEFAULT Default push button
    PBF_PUSHABLE Push button

  • bcrs
    [in] ButtonControlRectangleStyle_t value that specifies the style of focus rectangle of the button. The following table shows the possible values.

    Value Description
    CBR_CHECKBOX Calculates the focus rectangle for a check box or radio button, including buttons with the BS_CHECKBOX, BS_RADIOBUTTON, BS_AUTORADIOBUTTON, BS_3STATE, BS_AUTOCHECKBOX, or BS_AUTO3STATE styles.
    CBR_CHECKTEXT Draws the text for a check box or radio button, including buttons with the BS_CHECKBOX, BS_RADIOBUTTON, BS_AUTORADIOBUTTON, BS_3STATE, BS_AUTOCHECKBOX, or BS_AUTO3STATE styles.
    CBR_CLIENTRECT Specifies an owner-drawn button. An owner-drawn button is a button with the BS_OWNERDRAW style.
    CBR_GROUPFRAME Calculates the focus rectangle for a group box. A group box is a button with the BS_GROUPBOX style.
    CBR_GROUPTEXT Draws the text for a group box. A group box is a button with the BS_GROUPBOX style.
    CBR_PUSHBUTTON Specifies a push button or default push button. These buttons have the BS_PUSHBUTTON or BS_DEFPUSHBUTTON style.

  • alignment
    [in] WORD that specifies the alignment of the text. The following table shows the values that you can use, in combination with other values listed later in this parameter description, to specify the horizontal and vertical alignment of the button.

    Value Description
    HOR_ALIGN_MASK Use to determine the horizontal alignment of the text.
    VER_ALIGN_MASK Use to determine the vertical alignment of the text.

    The following table shows the possible values that you can combine with HOR_ALIGN_MASK by using a bitwise-OR operation to set the horizontal alignment.

    Value Description
    BS_LEFT Left alignment
    BS_RIGHT Right alignment
    BS_CENTER Center horizontal alignment

    The following table shows the possible values that you can combine with VER_ALIGN_MASK by using a bitwise-OR operation to set the vertical alignment.

    Value Description
    BS_BOTTOM Bottom alignment
    BS_TOP Top alignment
    BS_VCENTER Center vertical alignment

Remarks

ButtonView_t::DrawText is called when the button receives a WM_SETFOCUS, WM_KILLFOCUS, or BM_SETCHECK message. This method is also called when the state of the button changes, or when the button is painted.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Buttonview.hpp.

See Also

ButtonControlRectangleStyle_t | BM_SETCHECK | WM_KILLFOCUS | WM_SETFOCUS

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.