CToolBarCtrl::AddButtons

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ツールバーコントロールに 1 つ以上のボタンを追加します。

BOOL AddButtons(
   int nNumButtons,
   LPTBBUTTON lpButtons 
);

パラメータ

nNumButtons
追加するボタンの数。
lpButtons
追加するボタンの情報を持つ TBBUTTON 構造体の配列へのアドレス。配列には、nNumButtons で指定されたボタンの数と同じ数の要素が必要です。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

ポインタ 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
0 から始まるボタンイメージのインデックス。ボタンにイメージがない場合は -1 となります。
idCommand
ボタンに関連付けられるコマンド ID。この ID は、ボタンが選択されたときに WM_COMMAND メッセージで渡されます。fsStyle メンバが値 TBSTYLE_SEP を持っているときは、このメンバは 0 である必要があります。
fsState
ボタン状態フラグ。次に一覧する値を組み合わせることができます。
- TBSTATE_CHECKED ボタンはスタイルが TBSTYLE_CHECKED で、押された状態です。
- TBSTATE_ENABLED ボタンはユーザー入力を受け入れます。この状態を持たないボタンは、ユーザー入力を受け入れず、淡色表示されます。
- TBSTATE_HIDDEN ボタンは表示されず、ユーザー入力を受け入れることはできません。
- TBSTATE_INDETERMINATE ボタンは淡色表示されています。
- TBSTATE_PRESSED ボタンは押された状態です。
- TBSTATE_WRAP ボタンの後ろに改行が続きます。ボタンは TBSTATE_ENABLED 状態も持っている必要があります。
fsStyle
ボタンスタイル。次に一覧する値を組み合わせることができます。
- TBSTYLE_BUTTON 標準のプッシュボタンを作成します。
- TBSTYLE_CHECK ユーザーがクリックするたびに、押された状態と離された状態とを切り替えるボタンを作成します。ボタンが押された状態になると背景色が変わります。
- TBSTYLE_CHECKGROUP グループ内の別のボタンが押されるまで押されたままになるチェックボタンを作成します。
- TBSTYLE_GROUP グループ内の別のボタンが押されるまで押されたままになるボタンを作成します。
- TBSTYLE_SEP 各ボタングループ間に小さなすきまを与える区切り線を作成します。このスタイルのボタンはユーザー入力を受け入れません。
dwData
ユーザー定義データ。
iString
ボタンのラベルとして使われる文字列の 0 から始まるインデックス。ボタンに文字列がない場合は -1 となります。