共用方式為


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,如果沒有這個按鈕的字串。

使用 AddBitmapAddString,和 (或) AddStrings索引,您必須提供先前加入至工具列控制項的控制項清單中的影像和字串。

需求

Header: afxcmn.h

請參閱

參考

CToolBarCtrl 類別

階層架構圖

CToolBarCtrl::InsertButton

CToolBarCtrl::DeleteButton

CToolBarCtrl::AddBitmap

CToolBarCtrl::AddString

CToolBarCtrl::AddStrings