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
命令識別與按鈕。 當按鈕時，這個識別項 WM_COMMAND 訊息傳送。 如果 fsStyle 成員具有 TBSTYLE_SEP 值，這個成員必須是零。fsState
按鈕狀態旗標。 它可以是下列值的組合:TBSTATE_CHECKED 按鈕具有 TBSTYLE_CHECKED 模式並且已按下。
TBSTATE_ENABLED 按鈕可接受使用者輸入。 沒有這個狀態不接受使用者輸入的按鈕和灰色。
TBSTATE_HIDDEN 按鈕不是可見的，而且無法接收使用者輸入。
TBSTATE_INDETERMINATE ] 按鈕會變為灰色。
TBSTATE_PRESSED 按鈕已按下。
TBSTATE_WRAP A 分行符號後面的按鈕。 按鈕也都必須有 TBSTATE_ENABLED 狀態。
fsStyle
按鈕樣式。 它可以是下列值的組合:TBSTYLE_BUTTON 建立標準按鈕。
TBSTYLE_CHECK 建立切換按鈕的按鈕和未按下狀態之間每次使用者按一下。 表示處於已按下狀態時，按鈕的不同的背景色彩。
TBSTYLE_CHECKGROUP 建立保持按下的選取按鈕，直到另一個按鈕群組中的按鈕。
TBSTYLE_GROUP 指出為按鈕的按鈕，直到另一個按鈕群組中的按鈕。
TBSTYLE_SEP 建立分隔符號，提供按鈕群組之間的小型空白。 具有樣式的按鈕不會接收使用者輸入。
dwData
使用者定義的資料。iString
使用字串之以零起始的索引做為按鈕的標籤，則為-1，如果沒有這個按鈕的字串。
使用 AddBitmap、 AddString，和 (或) AddStrings索引，您必須提供先前加入至工具列控制項的控制項清單中的影像和字串。
需求
Header: afxcmn.h