CToolBarCtrl::AddButtons
ツール バー コントロールに一つ以上のボタンを追加します。
BOOL AddButtons(
int nNumButtons,
LPTBBUTTON lpButtons
);
パラメーター
nNumButtons
追加するボタンの数。lpButtons
追加するボタンに関する情報を含む TBBUTTON の構造体の配列のアドレス。ボタンとして nNumButtonsによって指定された配列の要素の数が同じである必要があります。
戻り値
成功した場合は; それ以外の場合は。
解説
TBBUTTON の構造体の配列への lpButtons のポインターのポインター。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
ボタンに関連付けられているコマンド ID。この識別子は WM_COMMAND のメッセージでボタンが選択されたときに送信されます。fsStyle のメンバーは TBSTYLE_SEP の値がの場合、このメンバーは、B があります。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を使用してツール バー コントロールの一覧に追加する必要がないイメージや文字列。
必要条件
ヘッダー: afxcmn.h