CMFCToolBar クラス

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

CMFCToolBar クラスは CToolBar クラスに似ていますが、ユーザーインターフェイス機能に対する追加サポートを提供します。フラットツールバー、ホットイメージのツールバー、大きいアイコン、ページャーボタン、ロックされたツールバー、rebar コントロール、イメージの下のテキスト、背景イメージ、およびタブ付きのツールバーなどがサポートされます。CMFCToolBar クラスには、ツールバーおよびメニューに対するユーザーのカスタマイズ、ツールバーとメニューの間のドラッグアンドドロップ、コンボボックスボタン、エディットボックスボタン、カラーピッカー、およびロールアップボタンのサポートも組み込まれています。

class CMFCToolBar : public CMFCBaseToolBar

メンバー

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

名前	説明
CMFCToolBar::CMFCToolBar	既定のコンストラクターです。
CMFCToolBar::~CMFCToolBar	デストラクターです。

パブリックメソッド

名前	説明
CMFCToolBar::AddBasicCommand	ユーザーがメニューを開いたときに常に表示されるコマンドの一覧にメニューコマンドを追加します。
CMFCToolBar::AddCommandUsage	指定されたコマンドに関連付けられたカウンターを 1 だけインクリメントします。
CMFCToolBar::AddToolBarForImageCollection	ユーザーインターフェイスリソースからアプリケーション内のイメージのコレクションへ、イメージを追加します。
CMFCToolBar::AdjustLayout	ツールバーのサイズと位置を再計算します。 (CBasePane::AdjustLayout をオーバーライドします。)
CMFCToolBar::AdjustSize	ツールバーのサイズを再計算します。
CMFCToolBar::AllowChangeTextLabels	ツールバーボタンのイメージの下にテキストラベルを表示できるかどうかを示します
CMFCToolBar::AreTextLabels	ツールバーボタンで、イメージの下のテキストラベルが現在表示されているかどうかを示します。
CMFCToolBar::AutoGrayInactiveImages	アクティブでないボタンのイメージの自動生成を有効または無効にします。
CMFCToolBar::ButtonToIndex	このツールバーの指定した CMFCToolBarButton クラスオブジェクトのインデックスを返します。
CMFCToolBar::CalcFixedLayout	ツールバーの水平サイズを計算します。(CBasePane::CalcFixedLayout をオーバーライドします。)
CMFCToolBar::CalcSize	レイアウト計算の処理の過程でフレームワークによって呼び出されます。(CPane::CalcSize をオーバーライドします。)
CMFCToolBar::CanHandleSiblings	ツールバーとその兄弟が同じペインに配置されているかどうかを判定します。
CMFCToolBar::CleanUpImages	ツールバーイメージに割り当てられたシステムリソースを解放します。
CMFCToolBar::CleanUpLockedImages	ロックされたツールバーイメージに割り当てられたシステムリソースを解放します。
CMFCToolBar::CanBeClosed	ユーザーがツールバーを閉じることができるかどうかを示します。(CBasePane::CanBeClosed をオーバーライドします。)
CMFCToolBar::CanBeRestored	カスタマイズ後にツールバーを元の状態に復元できるかどうかを判断します。
CMFCToolBar::CanFocus	ペインがフォーカスを受け取ることができるかどうかを指定します。(CBasePane::CanFocus をオーバーライドします。)
CMFCToolBar::CanHandleSiblings	ツールバーとその兄弟が同じペインに配置されているかどうかを判定します。
CMFCToolBar::CommandToIndex	指定したコマンド ID を持つ、ツールバー内のボタンのインデックスを返します。
CMFCToolBar::Create	CMFCToolBar オブジェクトを作成します。
CMFCToolBar::CreateEx	大きいアイコンなどの追加スタイルオプションを使用する CMFCToolBar オブジェクトを作成します。
CMFCToolBar::Deactivate	ツールバーを非アクティブにします。
CMFCToolBar::EnableCustomizeButton	ツールバーの末尾に表示される [ボタンの表示/非表示] ボタンを有効または無効にします。
CMFCToolBar::EnableDocking	メインフレームへのペインのドッキングを有効にします。(CBasePane::EnableDocking をオーバーライドします。)
CMFCToolBar::EnableLargeIcons	ツールバーボタンの大きいアイコンを有効、または無効にします。
CMFCToolBar::EnableQuickCustomization	ユーザーが Alt キーを押してボタンを新しい位置にドラッグできるようにするために、ツールバーのクイックカスタマイズを有効または無効にします。
CMFCToolBar::EnableReflections	コマンドリフレクションを有効または無効にします。
CMFCToolBar::EnableTextLabels	ツールバーボタンイメージの下のテキストラベルを有効または無効にします。
CMFCToolBar::FromHandlePermanent	指定されたウィンドウハンドルを含む CMFCToolBar オブジェクトへのポインターを取得します。
CMFCToolBar::GetAllButtons	ツールバー内のボタンの読み取り専用のリストを返します。
CMFCToolBar::GetAllToolbars	アプリケーション内のすべてのツールバーの読み取り専用のリストを返します。
CMFCToolBar::GetBasicCommands	アプリケーションで定義された基本コマンドの読み取り専用リストを返します。
CMFCToolBar::GetButton	指定されたツールバーボタンのインデックスを持つ CMFCToolBarButton オブジェクトへのポインターを返します。
CMFCToolBar::GetButtonInfo	指定したインデックス位置にあるボタンのコマンド ID、スタイル、およびイメージのインデックスを返します。
CMFCToolBar::GetButtonSize	ツールバー上の各ボタンの寸法を返します。
CMFCToolBar::GetButtonStyle	指定したインデックス位置にあるツールバーボタンの現在のスタイルを返します。
CMFCToolBar::GetButtonText	指定したインデックス位置にあるボタンのテキストラベルを返します。
CMFCToolBar::GetColdImages	アプリケーションで、ツールバーボタンのコールドイメージのコレクションへのポインターを返します。
CMFCToolBar::GetColumnWidth	ツールバーボタンの幅を返します。
CMFCToolBar::GetCommandButtons	アプリケーションのツールバーにある、指定されたコマンド ID を持つボタンのリストを返します。
CMFCToolBar::GetCount	ツールバーのボタンと区切りの数を返します。
CMFCToolBar::GetCustomizeButton	ツールバーに関連付けられた CMFCCustomizeButton オブジェクトへのポインターを取得します。
CMFCToolBar::GetDefaultImage	指定したコマンド ID を持つツールバーの、既定のイメージのインデックスを返します。
CMFCToolBar::GetDisabledImages	アプリケーションで無効ツールバーボタンで使用されているイメージのコレクションへのポインターを返します。
CMFCToolBar::GetDisabledMenuImages	アプリケーションで無効なメニューボタンで使用されているイメージのコレクションへのポインターを返します。
CMFCToolBar::GetDroppedDownMenu	現在サブメニューが表示されているメニューボタンオブジェクトへのポインターを取得します。
CMFCToolBar::GetGrayDisabledButtons	無効ボタンのイメージを通常のボタンイメージの淡色表示バージョンにするか、無効なボタンイメージのコレクションから得るようにするかを指定します。
CMFCToolBar::GetHighlightedButton	現在強調表示されているツールバーボタンへのポインターを返します。
CMFCToolBar::GetHotBorder	ツールバーボタンがホットトラッキングされているかどうかを確認します。
CMFCToolBar::GetHotTextColor	強調表示されているツールバーボタンのテキストの色を返します。
CMFCToolBar::GetHwndLastFocus	ツールバーが入力フォーカスを受け取る直前に入力フォーカスを持っていたウィンドウへのハンドルを返します。
CMFCToolBar::GetIgnoreSetText	定数のボタンのラベルへの呼び出しを無視するかどうかを指定します。
CMFCToolBar::GetImageSize	ツールバーボタンイメージの現在のサイズを返します。
CMFCToolBar::GetImages	アプリケーションにおける既定のボタンイメージのコレクションへのポインターを返します。
CMFCToolBar::GetImagesOffset	このツールバーのツールバーボタンイメージをツールバーボタンイメージのグローバルリスト内で検索するために使用するインデックスのオフセットを返します。
CMFCToolBar::GetInvalidateItemRect	特定のインデックスのボタンの、再描画が必要なクライアント領域内での部分を取得します。
CMFCToolBar::GetItemID	指定したインデックスのツールバーボタンのコマンド ID を返します。
CMFCToolBar::GetItemRect	指定されたインデックスのボタンの外接する四角形を返します。
CMFCToolBar::GetLargeColdImages	アプリケーションの、大きいツールバーボタンのコールドイメージのコレクションへのポインターを返します。
CMFCToolBar::GetLargeDisabledImages	アプリケーションの、大きい無効ツールバーボタンイメージのコレクションへのポインターを返します。
CMFCToolBar::GetLargeImages	アプリケーションの、大きいツールバーボタンイメージのコレクションへのポインターを返します。
CMFCToolBar::GetLockedColdImages	ツールバーの、ロックされたコールドイメージのコレクションへのポインターを返します。
CMFCToolBar::GetLockedDisabledImages	ツールバーの、ロックされた無効イメージのコレクションへのポインターを返します。
CMFCToolBar::GetLockedImages	ツールバーの、ロックされたボタンイメージのコレクションへのポインターを返します。
CMFCToolBar::GetLockedImageSize	ロックされたツールバーイメージの既定のサイズを返します。
CMFCToolBar::GetLockedMenuImages	ツールバーの、ロックされたツールバーメニューイメージのコレクションへのポインターを返します。
CMFCToolBar::GetMenuButtonSize	アプリケーション内のメニューボタンのサイズを返します。
CMFCToolBar::GetMenuImageSize	アプリケーションのメニューボタンイメージのサイズを返します。
CMFCToolBar::GetMenuImages	アプリケーションの、メニューボタンイメージのコレクションへのポインターを返します。
CMFCToolBar::GetOrigButtons	ツールバーの、カスタマイズされていないボタンのコレクションを取得します。
CMFCToolBar::GetOrigResetButtons	ツールバーのカスタマイズされていないリセットボタンのコレクションを取得します。
CMFCToolBar::GetResourceID	ツールバーのリソース ID を取得します。
CMFCToolBar::SetRouteCommandsViaFrame	親フレームとオーナーのどちらのオブジェクトがコマンドをツールバーに送信するかを確認します。
CMFCToolBar::GetRowHeight	ツールバーボタンの高さを返します。
CMFCToolBar::GetShowTooltips	ツールヒントをツールバーボタンに表示するかどうかを指定します。
CMFCToolBar::GetSiblingToolBar	ツールバーの兄弟を取得します。
CMFCToolBar::GetUserImages	アプリケーションの、ユーザー定義のツールバーボタンイメージのコレクションへのポインターを返します。
CMFCToolBar::HitTest	指定された位置にあるツールバーボタンのインデックスを返します。
CMFCToolBar::InsertButton	ツールバーにボタンを挿入します。
CMFCToolBar::InsertSeparator	ツールバーに区分線を挿入します。
CMFCToolBar::InvalidateButton	指定されたインデックスに存在するツールバーボタンのクライアント領域を無効にします。
CMFCToolBar::IsAddRemoveQuickCustomize	ユーザーが [カスタマイズ] のメニューオプションを使用してツールバーボタンを追加または削除できるかどうかを判定します。
CMFCToolBar::IsAltCustomizeMode	ボタンをドラッグするにクイックカスタマイズを使用するかどうかを指定します。
CMFCToolBar::IsAutoGrayInactiveImages	非アクティブな (強調表示されていない) ボタンのイメージの自動生成を有効にするかどうかを指定します。
CMFCToolBar::IsBasicCommand	コマンドが基本コマンドのリスト上にあるかどうかを確認します。
CMFCToolBar::IsButtonExtraSizeAvailable	拡張された境界を持つボタンをツールバーが表示できるかどうかを判断します
CMFCToolBar::IsButtonHighlighted	ツールバーボタンを強調表示するかどうかを判定します。
CMFCToolBar::IsCommandPermitted	コマンドが許可されているかどうかを判断します。
CMFCToolBar::IsCommandRarelyUsed	コマンドがほとんど使用されていないのかどうかを判断します (「CMFCToolBar::SetCommandUsageOptions」を参照)。
CMFCToolBar::IsCustomizeMode	ツールバーフレームワークがカスタマイズモードであるかどうかを指定します。
CMFCToolBar::IsDragButton	ツールバーのボタンをドラッグするかどうかを指定します。
CMFCToolBar::IsExistCustomizeButton	ツールバーに [Customize] ボタンがあるかどうかを判定します。
CMFCToolBar::IsFloating	ツールバーが固定されていないかどうかを判定します。
CMFCToolBar::IsLargeIcons	アプリケーションのツールバーに現在、大きいアイコンが表示されているかどうかを判断します。
CMFCToolBar::IsLastCommandFromButton	最後に実行したコマンドが、指定されたツールバーボタンから送信されたかどうかを判断します。
CMFCToolBar::IsLocked	ツールバーがロックされているかどうかを判断します。
CMFCToolBar::IsOneRowWithSibling	ツールバーとその兄弟ツールバーが同じ行に配置されているかどうか判断します。
CMFCToolBar::IsUserDefined	ツールバーがユーザー定義かどうかを指定します。
CMFCToolBar::LoadBitmap	アプリケーションリソースからツールバーイメージを読み込みます。
CMFCToolBar::LoadBitmapEx	アプリケーションリソースからツールバーイメージを読み込みます。大きいイメージが含まれます。
CMFCToolBar::LoadParameters	Windows レジストリからグローバルツールバーオプションを読み込みます。
CMFCToolBar::LoadState	Windows レジストリからツールバー状態情報を読み込みます。(CPane::LoadState をオーバーライドします。)
CMFCToolBar::LoadToolBar	アプリケーションリソースからツールバーを読み込みます。
CMFCToolBar::LoadToolBarEx	CMFCToolBarInfo ヘルパークラスを使用してアプリケーションリソースからツールバーを読み込み、アプリケーションで大きいイメージを使用できるようにします。
CMFCToolBar::OnChangeHot	ツールバー上のボタンが選択されたときに、フレームワークによって呼び出されます。
CMFCToolBar::OnFillBackground	ツールバーの背景を塗りつぶすために、フレームワークによって CBasePane::DoPaint から呼び出されます。
CMFCToolBar::OnReset	ツールバーを元の状態に戻します。
CMFCToolBar::OnSetAccData	(CBasePane::OnSetAccData をオーバーライドします。)
CMFCToolBar::OnSetDefaultButtonText	ツールバーボタンのテキストを既定の状態に復元します。
CMFCToolBar::OnUpdateCmdUI	内部使用。
CMFCToolBar::RemoveAllButtons	ツールバーからすべてのボタンを削除します。
CMFCToolBar::RemoveButton	指定したインデックスのボタンをツールバーから削除します。
CMFCToolBar::RemoveStateFromRegistry	ツールバーの状態情報を Windows レジストリから削除します。
CMFCToolBar::ReplaceButton	ツールバーボタンを別のツールバーボタンに置き換えます。
CMFCToolBar::ResetAll	すべてのツールバーを元の状態に復元します。
CMFCToolBar::ResetAllImages	アプリケーション内のすべてのツールバーイメージのコレクションをクリアします。
CMFCToolBar::RestoreOriginalstate	ツールバーの元の状態を復元します
CMFCToolBar::SaveState	ツールバーの状態情報を Windows レジストリに保存します。(CPane::SaveState をオーバーライドします。)
CMFCToolBar::Serialize	(CBasePane::Serialize をオーバーライドします。)
CMFCToolBar::SetBasicCommands	ユーザーがメニューを開いたときに常に表示されるコマンドの一覧を設定します。
CMFCToolBar::SetButtonInfo	ツールバーボタンのコマンド ID、スタイル、およびイメージ ID を設定します。
CMFCToolBar::SetButtonStyle	特定のインデックスのツールバーボタンのスタイルを設定します。
CMFCToolBar::SetButtonText	ツールバーボタンのテキストラベルを設定します。
CMFCToolBar::SetButtons	ツールバーのボタンを設定します。
CMFCToolBar::SetCommandUsageOptions	ほとんど使用されないコマンドを、どのような場合にアプリケーションのメニューに表示しないようにするかを指定します。
CMFCToolBar::SetCustomizeMode	アプリケーション内のすべてのツールバーのカスタマイズモードを有効または無効にします。
CMFCToolBar::SetGrayDisabledButtons	ツールバーの無効なボタンを淡色表示にするかどうか、また無効なボタンに無効なイメージを使用するかどうかを指定します。
CMFCToolBar::SetHeight	ツールバーの高さを設定します。
CMFCToolBar::SetHotBorder	ツールバーボタンがホットトラッキングされるかどうかを指定します。
CMFCToolBar::SetHotTextColor	ホットツールバーボタンのテキストの色を設定します。
CMFCToolBar::SetLargeIcons	ツールバーボタンに大きいアイコンを表示するかどうかを指定します。
CMFCToolBar::SetLockedSizes	ツールバー上のロックされたボタンおよびロックされたイメージのサイズを設定します
CMFCToolBar::SetMenuSizes	ツールバーメニューのボタンとそのイメージのサイズを設定します。
CMFCToolBar::SetNonPermittedCommands	ユーザーが実行できないコマンドの一覧を設定します。
CMFCToolBar::SetOneRowWithSibling	ツールバーとその兄弟を同じ行に配置します。
CMFCToolBar::GetItemRect	ユーザーがツールバーを閉じることができるかどうかを示します。
CMFCToolBar::SetRouteCommandsViaFrame	親フレームとオーナーのどちらがツールバーにコマンドを送信するかを指定します。
CMFCToolBar::SetShowTooltips	フレームワークにツールヒントを表示するかどうかを指定します。
CMFCToolBar::SetSiblingToolBar	ツールバーの兄弟を指定します。
CMFCToolBar::SetSizes	すべてのツールバーのボタンとイメージのサイズを指定します。
CMFCToolBar::SetToolBarBtnText	ツールバーのボタンのプロパティを指定します。
CMFCToolBar::SetTwoRowsWithSibling	ツールバーとその兄弟を別々の行に配置します。
CMFCToolBar::SetUserImages	アプリケーションにおけるユーザー定義のイメージのコレクションを設定します。
CMFCToolBar::StretchPane	ツールバーを垂直方向または水平方向に伸縮します。(CBasePane::StretchPane をオーバーライドします。)
CMFCToolBar::TranslateChar	指定したキーコードが有効なショートカットキーに対応するボタンのコマンドを実行します。
CMFCToolBar::UpdateButton	指定したボタンの状態を更新します。
CMFCToolBar::WrapToolBar	特定の次元内のツールバーボタンの位置を変更します。

プロテクトメソッド

名前	説明
CMFCToolBar::AllowShowOnList	[Customize] ダイアログボックスの [Toolbars] ペイン上の一覧に、ツールバーが表示されているかどうかを判断します。
CMFCToolBar::CalcMaxButtonHeight	ツールバーのボタンの高さの最大値を計算します。
CMFCToolBar::DoPaint	ツールバーを再描画します。
CMFCToolBar::DrawButton	ツールバーボタンを再描画します。
CMFCToolBar::DrawSeparator	ツールバーに区分線を再描画します。
CMFCToolBar::OnUserToolTip	ボタンのツールヒントを表示する直前に、フレームワークによって呼び出されます。

データメンバー

名前	説明
CMFCToolBar::m_bDontScaleImages	高解像度モードでツールバーのイメージを拡大縮小するかどうかを指定します。
CMFCToolBar::m_dblLargeImageRatio	大きいイメージの大きさ (高さまたは幅) と通常のイメージの大きさとの比を指定します。

解説

CMFCToolBar オブジェクトをアプリケーションに組み込むには、次の手順を実行します。

メインフレームウィンドウに CMFCToolBar オブジェクトを追加します。
メインフレームウィンドウの WM_CREATE メッセージを処理する場合は、CMFCToolBar::Create または CMFCToolBar::CreateEx を呼び出してツールバーを作成し、そのスタイルを指定します。
CBasePane::EnableDocking を呼び出してドッキングスタイルを指定します。

コンボボックスやドロップダウンツールバーのような特殊なボタンを挿入するには、親リソースでダミーボタンを予約し、実行時に CMFCToolBar::ReplaceButton を使用してダミーボタンを置き換えます。詳細については、「チュートリアル: ツールバーへのコントロールの追加」を参照してください。

CMFCToolBar は、MFC ライブラリクラス CMFCMenuBar クラス、CMFCPopupMenuBar クラスと CMFCDropDownToolBar クラスの基本クラスです。

使用例

CMFCToolBar クラスのさまざまなメソッドの使用方法を次の例に示します。この例では、ツールバーのウィンドウラベルのテキストの設定方法、境界線の設定方法、ペインのスタイルの設定方法、およびツールバーの末尾に表示される [ボタンの表示/非表示] ボタンを有効にする方法を示しています。このコードスニペットは IE のデモのサンプルの一部です。

    CMFCToolBar     m_wndToolBar;


...


    m_wndToolBar.SetWindowText (_T("Standard"));
    m_wndToolBar.SetBorders ();

    //------------------------------------
    // Remove toolbar gripper and borders:
    //------------------------------------
    m_wndToolBar.SetPaneStyle (m_wndToolBar.GetPaneStyle() &
        ~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));

    m_wndToolBar.EnableCustomizeButton (TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));