CToolBarCtrl::AddButtons

项目
03/01/2013

添加一个或多个按钮添加到工具栏控件。

BOOL AddButtons(
   int nNumButtons,
   LPTBBUTTON lpButtons 
);

参数

nNumButtons
添加按钮的数字。
lpButtons
包含有关按钮的信息添加数组的地址 TBBUTTON 结构。必须具有相同元素数目。nNumButtons为按钮指定的数组。

返回值

非零，如果成功;否则零。

备注

lpButtons 指针指向数组 TBBUTTON 结构。每 TBBUTTON 结构将添加的按钮与按钮的样式、图像和字符串、命令ID、状态和用户定义的数据:

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;

成员如下所示:

iBitmap
从零开始的索引按钮图像，-1，则此按钮的无图形。
idCommand
命令ID与按钮。当按钮时，此标识符在 WM_COMMAND 消息发送。如果 fsStyle 成员具有 TBSTYLE_SEP 值，此成员必须为零。
fsState
按钮状态标志。它可以是下面所列的值的组合:
- TBSTATE_CHECKED 按钮具有 TBSTYLE_CHECKED 样式和已按下。
- TBSTATE_ENABLED 按钮接受用户输入。没有此状态不接受用户输入的按钮和变灰。
- TBSTATE_HIDDEN 按钮不可见，并且无法接收用户输入。
- TBSTATE_INDETERMINATE 按钮的灰色。
- TBSTATE_PRESSED 按钮处于按下状态。
- TBSTATE_WRAP 的换行符遵循按钮。按钮还必须具有 TBSTATE_ENABLED 状态。
fsStyle
按钮样式。它可以是下面所列的值的组合:
- TBSTYLE_BUTTON 创建标准普通按钮。
- TBSTYLE_CHECK 创建切换在按的按钮和未压缩状态之间的用户每次单击它。在处于按下状态时，该按钮具有不同的背景色。
- TBSTYLE_CHECKGROUP 创建保持在的一个检查按钮，直到另一个按钮组中按。
- TBSTYLE_GROUP 创建保持按的按钮，直到另一个按钮组中按。
- TBSTYLE_SEP 创建一个分隔符，提供按钮组之间的一个小的空白。具有此样式的按钮不接收用户输入。
dwData
用户定义的数据。
iString
使用的字符串的从零开始的索引为按钮的标签，-1;如果没有此按钮的字符串。