Share via


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.

Note

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

Reference

CToolBar Class

Hierarchy Chart

CToolBar::GetButtonInfo