计算机术语“CToolBarCtrl::AddButtons”的中英文意思、释义、翻译及用法-计算机英汉双解词典

术语

CToolBarCtrl::AddButtons

释义

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

随便看

MFC类库中文详解手册包含4274条MFC类库参考词条，基本涵盖了Microsoft基本类库中的类、全局函数、全局变量和宏的内容，是计算机编程的有利工具。