CToolBarCtrl::AddButtons
添加一个或多个按钮添加到工具栏控件。
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;如果没有此按钮的字符串。
索引时提供了以前添加到工具栏的图形和字符串控件内容使用 AddBitmap、 AddString,和/或 AddStrings。
要求
Header: afxcmn.h