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按钮图像的从零开始的索引。如果这个按钮没有图像,则这个成员是NULL。
idCommand与此按钮相关联的命令标识符。当按钮被选择时,这个标识符在一个WM_COMMAND消息中被发送。如果fsStyle成员的值为TBSTYLE_SEP,则这个成员必须是零。
fsState按钮的状态标志。它可以是下面列出的值的一个组合:
·TBSTATE_CHECKED该按钮具有TBSTYLE_CHECKED风格并且被按下。
·TBSTATE_ENABLED按钮接收用户输入。一个不具有这个状态的按钮是不接收用户输入的,并且变灰。
·TBSTATE_HIDDEN按钮不可见,并且不能接收用户输入。
·TBSTATE_INDETERMINATE按钮是变灰的。
·TBSTATE_PRESSED按钮被按下。
·TBSTATE_WRAP按钮之后是一个分隔线。此按钮还必须具有TBSTATE_ENABLED状态。
sStyle按钮风格。它可以是下列值的一个组合:
·TBSTYLE_BUTTON创建一个标准的按钮。
·TBSTYLE_CHECK创建一个每次用户点击时可以在按下和弹起状态间切换的按钮。该按钮则处于按下状态时有一种不同的背景颜色。
·TBSTYLE_CHECKGROUP创建一个核选按钮,它被选择后一直处于按下状态,直到同组中的另一个按钮被按下时它才弹起。
·TBSTYLE_GROUP创建一个被选择后一直处于按下状态,直到同组中的另一个按钮被按下时它才弹起的按钮。
·TBSTYLE_SEP创建一个分隔线,为按钮组之间提供一个小的间距。具有这个风格的按钮是不接收用户输入的。
dwData用户定义的数据。
iString要用来作为按钮的标签的字符串的从零开始的索引。如果这个按钮没有字符串则这个值为NULL
你提供的图像和/或字符串的索引必须是已经通过调用AddBitmap,AddString,和/或AddStrings被添加到工具条控件的列表中的值。

请参阅:
CToolBarCtrl::InsertButton, CToolBarCtrl::DeleteButton, CToolBarCtrl::AddBitmap, CToolBarCtrl::AddString, CToolBarCtrl::AddStrings