CToolBarCtrl::AddButtons

Adds one or more buttons to a toolbar control.

BOOL AddButtons(
   int nNumButtons,
   LPTBBUTTON lpButtons 
);

Parameters

  • nNumButtons
    Number of buttons to add.

  • lpButtons
    Address of an array of TBBUTTON structures that contains information about the buttons to add. There must be the same number of elements in the array as buttons specified by nNumButtons.

Return Value

Nonzero if successful; otherwise zero.

Remarks

The lpButtons pointer points to an array of TBBUTTON structures. Each TBBUTTON structure associates the button being added with the button's style, image and/or string, command ID, state, and user-defined data:

typedef struct _TBBUTTON {

int iBitmap;// zero-based index of button image

int idCommand; // command to be sent when button pressed

BYTE fsState; // button state--see below

BYTE fsStyle; // button style--see below

DWORD dwData; // application-defined value

int iString;// zero-based index of button label string

} TBBUTTON;

The members are as follows:

  • iBitmap
    Zero-based index of button image, -1 if no image for this button.

  • idCommand
    Command identifier associated with the button. This identifier is sent in a WM_COMMAND message when the button is chosen. If the fsStyle member has the TBSTYLE_SEP value, this member must be zero.

  • fsState
    Button state flags. It can be a combination of the values listed below:

    • TBSTATE_CHECKED   The button has the TBSTYLE_CHECKED style and is being pressed.

    • TBSTATE_ENABLED   The button accepts user input. A button that does not have this state does not accept user input and is grayed.

    • TBSTATE_HIDDEN   The button is not visible and cannot receive user input.

    • TBSTATE_INDETERMINATE   The button is grayed.

    • TBSTATE_PRESSED   The button is being pressed.

    • TBSTATE_WRAP   A line break follows the button. The button must also have the TBSTATE_ENABLED state.

  • fsStyle
    Button style. It can be a combination of the values listed below:

    • TBSTYLE_BUTTON   Creates a standard push button.

    • TBSTYLE_CHECK   Creates a button that toggles between the pressed and unpressed states each time the user clicks it. The button has a different background color when it is in the pressed state.

    • TBSTYLE_CHECKGROUP   Creates a check button that stays pressed until another button in the group is pressed.

    • TBSTYLE_GROUP   Creates a button that stays pressed until another button in the group is pressed.

    • TBSTYLE_SEP   Creates a separator, providing a small gap between button groups. A button that has this style does not receive user input.

  • dwData
    User-defined data.

  • iString
    Zero-based index of the string to use as the button's label, -1 if there is no string for this button.

The image and/or string whose index you provide must have previously been added to the toolbar control's list using AddBitmap, AddString, and/or AddStrings.

Requirements

Header: afxcmn.h

See Also

Concepts

CToolBarCtrl Class

CToolBarCtrl Members

Hierarchy Chart

CToolBarCtrl::InsertButton

CToolBarCtrl::DeleteButton

CToolBarCtrl::AddBitmap

CToolBarCtrl::AddString

CToolBarCtrl::AddStrings