CToolBar::SetButtonInfo

Call this member function to set the button's command ID, style, and image number.

void SetButtonInfo(
   int nIndex,
   UINT nID,
   UINT nStyle,
   int iImage 
);

Parameters

  • nIndex
    Zero-based index of the button or separator for which information is to be set.

  • nID
    The value to which the button's command ID is set.

  • nStyle
    The new button style. The following button styles are supported:

    • TBBS_BUTTON   Standard pushbutton (default)

    • TBBS_SEPARATOR   Separator

    • TBBS_CHECKBOX   Auto check-box button

    • TBBS_GROUP   Marks the start of a group of buttons

    • TBBS_CHECKGROUP   Marks the start of a group of check-box buttons

    • **TBBS_DROPDOWN   **Creates a drop-down list button.

    • **TBBS_AUTOSIZE   **The button's width will be calculated based on the text of the button, not on the size of the image.

    • **TBBS_NOPREFIX   **The button text will not have an accelerator prefix associated with it.

  • iImage
    New index for the button's image within the bitmap.

Remarks

For separators, which have the style TBBS_SEPARATOR, this function sets the separator's width in pixels to the value stored in iImage.

备注

You can also set button states using the nStyle parameter; however, because button states are controlled by the ON_UPDATE_COMMAND_UI handler, any state you set using SetButtonInfo will be lost during the next idle processing. See How to Update User-Interface Objects and TN031: Control Bars for more information.

For information on bitmap images and buttons, see the CToolBar Overview and CToolBar::LoadBitmap.

Requirements

Header: afxext.h

See Also

Concepts

CToolBar Class

CToolBar Members

Hierarchy Chart

CToolBar::GetButtonInfo