CToolBar クラス

[アーティクル]
02/21/2013

一連のビットマップボタンおよびオプションの区切り記号を含むコントロールバーです。

class CToolBar : public CControlBar

メンバー

パブリックコンストラクター

名前	説明
CToolBar::CToolBar	CToolBar オブジェクトを構築します。

パブリックメソッド

名前	説明
CToolBar::CommandToIndex	指定したコマンド ID を持つボタンのインデックスを返します。
CToolBar::Create	Windows ツールバーを作成して CToolBar のオブジェクトにアタッチします。
CToolBar::CreateEx	CToolBarCtrl の埋め込みオブジェクトの追加スタイルの CToolBar のオブジェクトを作成します。
CToolBar::GetButtonInfo	ボタンの ID、スタイル、およびイメージ数を取得します。
CToolBar::GetButtonStyle	ボタンのスタイルを取得します。
CToolBar::GetButtonText	ボタンに表示されるテキストを取得します。
CToolBar::GetItemID	指定したインデックス位置にあるボタンまたは区切り記号のコマンド ID を返します。
CToolBar::GetItemRect	指定されたインデックスの項目を表示する四角形を取得します。
CToolBar::GetToolBarCtrl	基になるコモンコントロールであるに直接アクセスできます。
CToolBar::LoadBitmap	ビットマップボタンのイメージを含むビットマップを読み込みます。
CToolbar::LoadToolBar	リソースエディターで作成されたツールバーリソースを読み込みます。
CToolBar::SetBitmap	ビットマップイメージを設定します。
CToolBar::SetButtonInfo	ボタンの ID、スタイル、およびイメージ数を設定します。
CToolBar::SetButtons	セットは、ビットマップ内のボタンイメージのスタイルとインデックスにボタンの値。
CToolBar::SetButtonStyle	ボタンのスタイルを設定します。
CToolBar::SetButtonText	ボタンに表示されるテキストを設定します。
CToolBar::SetHeight	ツールバーの高さを設定します。
CToolBar::SetSizes	ボタンおよびビットマップのサイズを設定します。

解説

ボタンは、プッシュボタン、チェックボックスのボタン、またはラジオボタンのように動作します。CToolBar のオブジェクトは、通常、クラス CFrameWnd か CMDIFrameWndから派生したフレームウィンドウオブジェクトの埋め込みメンバーです。

CToolBar::GetToolBarCtrlの MFC 4.0 に新しいメンバー関数は、ツールバーのカスタマイズと追加の機能の Windows コモンコントロールのサポートを利用できるようにします。CToolBar のメンバー関数は、Windows コモンコントロールの機能の最もいます; ただし、GetToolBarCtrlを呼び出すと、/98 のツールバー、ツールバー、Windows 95 の特性をさらに指定できます。GetToolBarCtrlを呼び出すと、CToolBarCtrl のオブジェクトへの参照を返します。Windows コモンコントロールを使用してツールバーのデザインに関する詳細については、CToolBarCtrl を参照してください。コモンコントロールについては、Windows SDKの [コモンコントロール] を参照してください。

Visual C++ は 2 とおりの方法をツールバーを作成する方法について説明します。リソースエディターを使用してツールバーリソースを作成するには、次の手順を実行する:

ツールバーリソースを作成します。
CToolBar オブジェクトを構築します。
Windows ツールバーを作成して CToolBar のオブジェクトにアタッチするに [作成] (または) CreateEx関数を呼び出します。
ツールバーリソースを読み込みます LoadToolBar。

それ以外の場合は、次の手順を実行します。

CToolBar オブジェクトを構築します。
Windows ツールバーを作成して CToolBar のオブジェクトにアタッチするに [作成] (または) CreateEx関数を呼び出します。
ツールバーボタンのイメージを含むビットマップを読み込むに LoadBitmap を呼び出します。
ボタンのスタイルを設定し、ビットマップイメージと各ボタンを関連付けるに SetButtons を呼び出します。

ツールバーのすべてのボタンのイメージは、ボタンごとに 1 のイメージを含める必要がある 1 個のビットマップから作成されます。すべてのイメージは同じサイズである必要があります; 既定の幅は 16 ピクセル、高さ 15 ピクセルです。イメージはビットマップで side-by-side である必要があります。

SetButtons 関数は、コントロールの ID と配列の要素の数を指定する整数の配列へのポインターを渡します。関数は、配列の対応する要素の値に、各ボタンの ID を設定し、各ボタンにビットマップでボタンのイメージの位置を指定するイメージのインデックスを割り当てます。配列要素に値 ID_SEPARATORがある場合、イメージインデックスは使用できません。

ビットマップイメージの順序は、通常は、それらが画面に描画、イメージの順序と描画の順序との関係を変更するに SetButtonInfo 関数を使用する順序です。

ツールバーのすべてのボタンは同じサイズです。既定値は、ソフトウェア設計の Windows インターフェイスのガイドラインに従って、24 x 22 ピクセルです。イメージとボタンの寸法間の追加の空間がイメージの周囲に境界線を形成するために使用されます。

各ボタンに、1 種類のイメージがあります。さまざまなボタンの状態とスタイル (、無効にすると、中間無効な上で押す)、1 種類のイメージから生成されます。ビットマップがどの色ですが、色合い灰色の黒のイメージの最適な結果を得ることができます。

注意
CToolBar は最大 16 色のビットマップをサポートします。ツールバーエディターにイメージを読み込むと、Visual Studio は 16 色のビットマップに自動的にイメージが変換済みイメージを必要に応じて変換し、警告メッセージが表示されます。16 色以上のイメージ (イメージを編集する外部エディターを使用して) を使用する場合は、アプリケーションが予期せずに終了することがあります。

CToolBar は最大 16 色のビットマップをサポートします。ツールバーエディターにイメージを読み込むと、Visual Studio は 16 色のビットマップに自動的にイメージが変換済みイメージを必要に応じて変換し、警告メッセージが表示されます。16 色以上のイメージ (イメージを編集する外部エディターを使用して) を使用する場合は、アプリケーションが予期せずに終了することがあります。

ツールバーボタンはプッシュボタンが既定でシミュレートします。ただし、ツールバーボタンまたはチェックボックスのボタン (ラジオボタンをシミュレートできます。チェックボックスのボタンは、3 種類の状態があります: オン、オフにすると、中間。ラジオボタンは 2 種類の状態だけがあります: チェックし、を選択します。

配列に指定しないで個々のボタンまたは区切り記号のスタイルを設定するには、スタイルを取得するために GetButtonStyle を呼び出して次に SetButtonsの代わりに SetButtonStyle を呼び出します。SetButtonStyle は、実行時にボタンのスタイルを変更する場合に便利です。

ボタンに表示するテキストをに割り当てるにはテキストをボタンに表示されるように取得できるように GetButtonText を呼び出し、次にテキストを設定するに SetButtonText を呼び出します。

チェックボックスのボタンを作成するか、スタイル TBBS_CHECKBOX を割り当てるか、または CCmdUI のオブジェクトの SetCheck のメンバー関数を ON_UPDATE_COMMAND_UI のハンドラーで実行します。SetCheck を呼び出すと、チェックボックスのボタンにプッシュボタンを切り替えます。SetCheck にオフの場合は 0、チェックされたの 1、または中間の 2 引数を渡します。

ラジオボタンを作成するには、ON_UPDATE_COMMAND_UI のハンドラーから CCmdUI のオブジェクトの SetRadio のメンバー関数を呼び出します。SetRadio にチェックインされるのかオフに非ゼロの 0 引数を渡します。オプショングループの相互に排他的な動作を提供するには、グループのすべてのボタンの ON_UPDATE_COMMAND_UI のハンドラーが必要です。

CToolBarの使用の詳細については、" " MFC ツールバーの実装とテクニカルノート 31: コントロールバーを参照してください。