CToolBarCtrl クラス

Windows ツール バー コモン コントロールの機能が用意されています。

class CToolBarCtrl : public CWnd

メンバー

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

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

パブリック メソッド

名前	説明
CToolBarCtrl::AddBitmap	ツール バー コントロールで使用できるボタン イメージのリストに一つ以上のビットマップ ボタンのイメージを追加します。
CToolBarCtrl::AddButtons	ツール バー コントロールに一つ以上のボタンを追加します。
CToolBarCtrl::AddString	リソース id として渡されたツール バーの文字列の内部リストに新しい文字列を追加します。
CToolBarCtrl::AddStrings	null 区切り文字列バッファーとして渡されるポインター ツール バーの文字列の内部リストに新しい文字列を追加します。
CToolBarCtrl::AutoSize	ツール バー コントロールのサイズを変更します。
CToolBarCtrl::ChangeBitmap	現在のツール バー コントロールのボタンのビットマップを変更します。
CToolBarCtrl::CheckButton	チェックまたはクリアします。ツール バー コントロールのボタン。
CToolBarCtrl::CommandToIndex	指定したコマンド ID に関連付けられたボタン用のインデックスを取得します。
CToolBarCtrl::Create	ツール バー コントロールを作成し、CToolBarCtrl のオブジェクトにアタッチします。
CToolBarCtrl::CreateEx	指定されたウィンドウの拡張スタイルのツール バー コントロールを作成し、CToolBarCtrl のオブジェクトにアタッチします。
CToolBarCtrl::Customize	ツール バーのカスタマイズ ダイアログ ボックスを表示します。
CToolBarCtrl::DeleteButton	ツール バー コントロールのボタンを削除します。
CToolBarCtrl::EnableButton	ツール バーの指定コントロール ボタンを有効または無効にします。
CToolBarCtrl::GetAnchorHighlight	ツール バーのアンカーの強調表示の設定を取得します。
CToolBarCtrl::GetBitmap	ツール バー ボタンに関連付けられたビットマップのインデックスを取得します。
CToolBarCtrl::GetBitmapFlags	フラグをツール バー ビットマップに関連付けられているを取得します。
CToolBarCtrl::GetButton	ツール バー ボタン コントロールの指定に関する情報を取得します。
CToolBarCtrl::GetButtonCount	ツール バー コントロール ボタンの数を現在取得します。
CToolBarCtrl::GetButtonInfo	ツール バー ボタンの情報を取得します。
CToolBarCtrl::GetButtonSize	ピクセルのツール バー ボタンの現在の幅と高さを取得します。
CToolBarCtrl::GetColorScheme	現在のツール バー コントロールの配色を取得します。
CToolBarCtrl::GetDisabledImageList	無効なボタンを表示する場合は、ツール バー コントロールが使用するイメージ リストを取得します。
CToolBarCtrl::GetDropTarget	ツール バー コントロールの IDropTarget のインターフェイスを取得します。
CToolBarCtrl::GetExtendedStyle	ツール バー コントロールの拡張スタイルを取得します。
CToolBarCtrl::GetHotImageList	「ホット」ボタンを表示する場合は、ツール バー コントロールが使用するイメージ リストを取得します。ホット ボタンは、マウス ポインターは、の上にあることを強調表示されます。
CToolBarCtrl::GetHotItem	ツール バーのホット項目のインデックスを取得します。
CToolBarCtrl::GetImageList	既定のボタンを表示する場合は、ツール バー コントロールが使用するイメージ リストを取得します。
CToolBarCtrl::GetInsertMark	ツール バーの現在の挿入マークを取得します。
CToolBarCtrl::GetInsertMarkColor	ツール バーの挿入マークの描画色を取得します。
CToolBarCtrl::GetItemRect	ツール バー コントロール ボタンの外接する四角形を取得します。
CToolBarCtrl::GetMaxSize	ツール バーに表示されるボタンと区切りすべての合計サイズを取得します。
CToolBarCtrl::GetMaxTextRows	ツール バー ボタンに表示されるテキストの行の最大数を取得します。
CToolBarCtrl::GetMetrics	ツール バー コントロールのメトリックを取得します。
CToolBarCtrl::GetPadding	現在のツール バー コントロールの水平方向と垂直方向の埋め込みを取得します。
CToolBarCtrl::GetPressedImageList	押された状態のボタンを表すために現在のツール バー コントロールが使用するイメージ リストを取得します。
CToolBarCtrl::GetRect	指定されたツール バー ボタンの外接する四角形を取得します。
CToolBarCtrl::GetRows	現在ツール バーに表示されるボタンの行数を取得します。
CToolBarCtrl::GetState	有効にするか、押された場合はオンにするかどうかをツール バー コントロール内の指定されたボタンの状態に関する情報を、のような取得します。
CToolBarCtrl::GetString	ツール バーの文字列を取得します。
CToolBarCtrl::GetStyle	ツール バー コントロールに現在使用中のスタイルを取得します。
CToolBarCtrl::GetToolTips	ある場合は、ツール バー コントロールに関連付けられているツール ヒント コントロールのハンドルを取得します。
CToolBarCtrl::HideButton	非表示を切り替えツール バー ボタン コントロールの指定。
CToolBarCtrl::HitTest	ポイントがツール バー コントロールのどこにあるかを判断します。
CToolBarCtrl::Indeterminate	設定またはクリアします。ツール バー コントロールのボタンの書式指定 (灰色) の状態。
CToolBarCtrl::InsertButton	ツール バー コントロール ボタンを挿入します。
CToolBarCtrl::InsertMarkHitTest	ツール バーのポイントの挿入マークの情報を取得します。
CToolBarCtrl::IsButtonChecked	ツール バーの指定コントロール ボタンがオンになっているかどうかを示します。
CToolBarCtrl::IsButtonEnabled	ツール バー ボタン コントロールの指定が有効かどうかを示します。
CToolBarCtrl::IsButtonHidden	ツール バーの指定コントロール ボタンが非表示かどうかを示します。
CToolBarCtrl::IsButtonHighlighted	ツール バー ボタンの強調表示状態をチェックします。
CToolBarCtrl::IsButtonIndeterminate	ツール バーの指定コントロール ボタンの状態が呼び出されるかどうかも示します (灰色)。
CToolBarCtrl::IsButtonPressed	ツール バーの指定コントロール ボタンが押されたかどうかを示します。
CToolBarCtrl::LoadImages	ツール バーのイメージ リストへの読み込みのビットマップ。
CToolBarCtrl::MapAccelerator	ツール バー ボタンにアクセラレータの文字をマップします。
CToolBarCtrl::MarkButton	ツール バー コントロールのボタンの強調表示状態を設定します。
CToolBarCtrl::MoveButton	1 種類のインデックスから別のツール バーにボタンを実行します。
CToolBarCtrl::PressButton	Enter キーまたはリリース ツール バー ボタン コントロールの指定。
CToolBarCtrl::ReplaceBitmap	新しいビットマップと現在のツール バー コントロールの既存のビットマップを置き換えます。
CToolBarCtrl::RestoreState	ツール バー コントロールの状態を復元します。
CToolBarCtrl::SaveState	ツール バー コントロールの状態を保存します。
CToolBarCtrl::SetAnchorHighlight	ツール バーのアンカーの強調表示を設定します。
CToolBarCtrl::SetBitmapSize	ツール バー コントロールに追加するビットマップ イメージのサイズを設定します。
CToolBarCtrl::SetButtonInfo	ツール バーの既存のボタンの情報を設定します。
CToolBarCtrl::SetButtonSize	ツール バー コントロールに追加するボタンのサイズを設定します。
CToolBarCtrl::SetButtonStructSize	TBBUTTON の構造体のサイズを指定します。
CToolBarCtrl::SetButtonWidth	ツール バーの最小値と最大のボタンの幅を設定します。
CToolBarCtrl::SetCmdID	指定したボタンを押すと、オーナー ウィンドウに送信されるコマンド ID を設定します。
CToolBarCtrl::SetColorScheme	現在のツール バー コントロールの配色を設定します。
CToolBarCtrl::SetDisabledImageList	無効なボタンを表示する場合は、ツール バー コントロールが使用するイメージ リストを設定します。
CToolBarCtrl::SetDrawTextFlags	書式設定する Win32 関数 DrawTextのフラグがどのように設定するためのフラグを指定して、テキストを四角形内に描画に使用する設定します。
CToolBarCtrl::SetExtendedStyle	ツール バー コントロールの拡張スタイルを設定します。
CToolBarCtrl::SetHotImageList	「ホット」ボタンを表示する場合は、ツール バー コントロールが使用するイメージ リストを設定します。
CToolBarCtrl::SetHotItem	ツール バーのホット アイテムを設定します。
CToolBarCtrl::SetImageList	既定の状態のボタンを表示する場合は、ツール バーで使用されるイメージ リストを設定します。
CToolBarCtrl::SetIndent	ツール バーの最初のボタンのインデントを設定します。
CToolBarCtrl::SetInsertMark	ツール バーの現在の挿入マークを設定します。
CToolBarCtrl::SetInsertMarkColor	色をツール バーの挿入マークの描画に使用する設定します。
CToolBarCtrl::SetMaxTextRows	ツール バー ボタンに表示されるテキストの行の最大数を設定します。
CToolBarCtrl::SetMetrics	ツール バー コントロールのメトリックを設定します。
CToolBarCtrl::SetOwner	ウィンドウのツール バー コントロールからの通知メッセージを受信するに設定します。
CToolBarCtrl::SetPadding	現在のツール バー コントロールの水平方向と垂直方向の埋め込みを設定します。
CToolBarCtrl::SetPressedImageList	押された状態のボタンを表すために現在のツール バー コントロールが使用するイメージ リストを設定します。
CToolBarCtrl::SetRows	ツール バーに表示されるボタン列数を設定します。
CToolBarCtrl::SetState	ツール バーの指定コントロール ボタンの状態を設定します。
CToolBarCtrl::SetStyle	ツール バー コントロールのスタイルを設定します。
CToolBarCtrl::SetToolTips	ツール バー コントロールでツール ヒント コントロールに関連付けます。
CToolBarCtrl::SetWindowTheme	ツール バー コントロールでの視覚スタイルを設定します。

解説

このコントロール (したがって CToolBarCtrl のクラス) /98 Windows 95 および Windows NT 3.51 以降で実行されるプログラムにのみ使用できます。

Windows ツール バー コモン コントロールは、一つ以上のボタンを含む四角形の子ウィンドウです。これらのボタンは、ビットマップ イメージ、または両方を表示できます。ユーザーがボタンをクリックした場合、ツール バーのオーナー ウィンドウにコマンド メッセージを送信します。通常、ツール バー ボタンはアプリケーションのメニュー項目に対応します; これらは、ユーザーが直接の方法をアプリケーションのコマンド アクセスを提供します。

CToolBarCtrl のオブジェクトは、いくつかの重要な内部のデータ構造体が含まれています: ボタンのイメージのビットマップ イメージのリストまたはリスト、ボタンのラベル文字列のリスト、および位置と文字列を、イメージやスタイルを示す作ったり、関連付ける TBBUTTON の構造体のリストは、ボタンのコマンド ID。これらのデータ構造体の各要素には、から始まるインデックスで参照されます。CToolBarCtrl のオブジェクトを使用する前に、これらのデータ構造を設定する必要があります。文字列のリストはボタンのラベルにしか使用できません; ツール バーから文字列を取得できません。

CToolBarCtrl のオブジェクトを使用するには、通常、次の手順を実行します:

1. CToolBarCtrl オブジェクトを構築します。

2. Windows ツール バー コモン コントロールを作成し、CToolBarCtrl のオブジェクトにアタッチするに [作成] を呼び出します。透明なツール バーに TBSTYLE_TRANSPARENT またはツール バーに TBSTYLE_DROPDOWN のようなスタイルを使用してツール バー スタイルをサポートするドロップダウン スタイルのボタンという名前を付けます。

3. 表示するツール バー ボタンがする方法を識別する:

   • ボタンのビットマップ イメージを使用するには、AddBitmapを呼び出して、ツール バーにボタンのビットマップを追加します。

   • イメージ リストから表示されるボタンのイメージを使用するには、SetImageList、SetHotImageList、または SetDisabledImageListを呼び出してイメージ リストを指定します。

   • ボタンの文字列のラベルを使用するには、AddString や AddStringsを呼び出して、ツール バーに文字列を追加します。

4. AddButtonsを呼び出して、ツール バーにボタンの構造を追加します。

5. CFrameWndではないオーナー ウィンドウのツール バーのボタンのツール ヒントが必要な場合は、ツール ヒントの通知の処理に説明されているように、ツール バーのオーナー ウィンドウの TTN_NEEDTEXT のメッセージを処理する必要があります。ツール バーの親ウィンドウが CFrameWndから派生している場合、ツール ヒントは、からの際の作業を行わずに CFrameWnd が既定のハンドラーを提供するため表示されます。

6. ユーザーにツール バーをカスタマイズする場合は、カスタマイズの通知の処理に説明されているように、オーナー ウィンドウのカスタマイズの通知メッセージを処理します。

レジストリに格納されている情報に基づいて状態を復元するためにレジストリと RestoreState ツール バー コントロールの現在の状態を保存するために SaveState を使用できます。アプリケーションのどちらのツール バーの状態を保存することに加えて、アプリケーションでは、通常、ユーザーが後にツール バーを元の状態に復元するには、ユーザーがツール バーをカスタマイズを開始する前に状態を格納します。

Internet Explorer Version 4.0 のサポート以降

Internet Explorer で、バージョン 4.0 以降で導入されたツール バー コントロールにサポートするには、の機能を MFC イメージ リストのサポートと透明に、フラット スタイルを指定します。

透過的なツール バーの下でクライアントが示すことができます。透明なツール バーを作成するには、TBSTYLE_FLAT との両方 TBSTYLE_TRANSPARENT スタイルを使用します。透明なツール バー、ホット トラッキングが使用されています; つまり、マウス ポインターがツール バーのホット ボタンの上に移動すると、ボタンの外観は変化します。、TBSTYLE_FLAT のスタイルで作成されたツール バーは透過的でないボタンがあります。

イメージ リストのサポートは、コントロールの既定の動作、ホット イメージと無効イメージの柔軟性を提供します。状態に従ってイメージの処理に透明なツール バーの GetImageList、GetHotImageListと GetDisabledImageList の使用:

CToolBarCtrlの使用の詳細については、コントロール と を使用して CToolBarCtrlを参照してください。

継承階層

CObject

CCmdTarget

CWnd

CToolBarCtrl

必要条件

ヘッダー : afxcmn.h

参照

関連項目

CWnd クラス

階層図

CToolBar クラス

概念

MFC CMNCTRL1 サンプル

MFC MFCIE サンプル