CToolBarCtrl::AddButtons

發行項
02/28/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
命令識別與按鈕。當按鈕時，這個識別項 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，如果沒有這個按鈕的字串。