Share via

CMFCToolBar クラス

  • [アーティクル]

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

詳細については、たとえば、Visual Studio のインストール %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfcにあるソース コードを参照してください。

構文

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 Class オブジェクトのインデックスを返します。
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::GetRouteCommandsViaFrame どのオブジェクト (親フレームまたは所有者) がツール バーにコマンドを送信するかを決定します。
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 ツール バーに [カスタマイズ] ボタンが含まれているかどうかを指定します。
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::SetPermament ユーザーがツール バーを閉じることができるかどうかを指定します。
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 [カスタマイズ] ダイアログ ボックスの [ツール バー] ウィンドウの一覧にツール バーを表示するかどうかを指定します。
CMFCToolBar::CalcMaxButtonHeight ツール バーのボタンの最大高さを計算します。
CMFCToolBar::DoPaint ツール バーを再描画します。
CMFCToolBar::DrawButton ツール バー ボタンを再描画します。
CMFCToolBar::DrawSeparator ツールバーの区切り記号を再描画します。
CMFCToolBar::OnUserToolTip ボタンのツールヒントが表示されようとしているときにフレームワークによって呼び出されます。

データ メンバー

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

解説

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

  1. CMFCToolBarメイン フレーム ウィンドウにオブジェクトを追加します。

  2. メイン フレーム ウィンドウのWM_CREATE メッセージを処理する場合は、いずれかCMFCToolBar::Createを呼び出すか、ツール CMFCToolBar::CreateEx バーを作成してそのスタイルを指定します。

  3. ドッキング スタイルを指定する呼び出し CBasePane::EnableDocking 。

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

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

例

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..."));

必要条件

ヘッダー:afxtoolbar.h

継承階層

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCToolBar::AddBasicCommand

ユーザーがメニューを開いたときに常に表示されるコマンドの一覧にメニュー コマンドを追加します。

static void __stdcall AddBasicCommand(UINT uiCmd);

パラメーター

uiCmd
[in]追加するコマンドを指定します。

解説

メニューを開くと、基本コマンドが常に表示されます。 このメソッドは、ユーザーが最近使用したコマンドを表示することを選択した場合に意味があります。

このメソッドを CMFCToolBar::SetBasicCommands 使用して、ユーザーがメニューを開いたときに常に表示されるコマンドの一覧を設定します。 このメソッドを CMFCToolBar::GetBasicCommands 使用して、アプリケーションで使用される基本的なコマンドの一覧を取得します。

CMFCToolBar::AddCommandUsage

指定されたコマンドに関連付けられているカウンターを 1 ずつインクリメントします。

static void __stdcall AddCommandUsage(UINT uiCommand);

パラメーター

uiCommand
[in]インクリメントするコマンド カウンターを指定します。

解説

フレームワークは、ユーザーがメニュー項目を選択したときにこのメソッドを呼び出します。

フレームワークは、コマンド カウンターを使用して最近使用したメニュー項目を表示します。

このメソッドは、メソッドを使用してコマンド カウンターを CMFCCmdUsageCount::AddCmd インクリメントします。

CMFCToolBar::AddToolBarForImageCollection

ユーザー インターフェイス リソースからアプリケーション内のイメージのコレクションにイメージを追加します。

static BOOL __stdcall AddToolBarForImageCollection(
    UINT uiResID,
    UINT uiBmpResID=0,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

パラメーター

uiResID
[in]読み込むイメージを含むツール バーのリソース ID。

uiBmpResID
[in]ツール バー イメージを含むビットマップのリソース ID。

uiColdResID
[in]"コールド" ツール バー イメージを含むビットマップのリソース ID。

uiMenuResID
[in]メニュー イメージを含むビットマップのリソース ID。

uiDisabledResID
[in]ツール バー イメージが無効になっているビットマップのリソース ID。

uiMenuDisabledResID
[in]無効なメニュー イメージを含むビットマップのリソース ID。

戻り値

TRUEメソッドが成功した場合。FALSE有効なリソースを指定しない場合uiBmpResID、または別のエラーが発生した場合uiResID。

解説

ツール バー イメージを含むビットマップを読み込み、ツール バー イメージのコレクションに追加するには、このメソッドを呼び出します。 このメソッドは、一時的なツール バー オブジェクトと呼び出 CMFCToolBar::LoadToolBarしを作成します。

CMFCToolBar::AdjustLayout

ツール バーのサイズと位置を再計算します。

virtual void AdjustLayout();

解説

ツール バーが作成されたときにこのメソッドを呼び出して、サイズと位置を再計算します。

フレームワークは、ツール バーのレイアウトを変更する必要があるたびに、このメソッドを呼び出します。 たとえば、ユーザーが別のコントロール バーを移動したり、アプリケーション ウィンドウのサイズを変更したり、ツール バーをカスタマイズしたりするときに、レイアウトを変更する必要があります。

派生元 CMFCToolbarのクラスで独自の動的レイアウトを提供するには、このメソッドをオーバーライドします。

CMFCToolBar::AdjustSize

ツール バーのサイズを再計算します。

void AdjustSize();

解説

このメソッドは、ツールバーが親フレームの境界に収まるようにします。 ツール バーに親フレームがない場合、このメソッドは何も行いません。

ツール バーの CMFCToolBar::AdjustLayout 親がオブジェクトでない場合は、このメソッドを呼び出してサイズを CMFCReBar 再計算します。

CMFCToolBar::AllowChangeTextLabels

ツール バー ボタンの画像の下にテキスト ラベルを表示できるかどうかを指定します。

virtual BOOL AllowChangeTextLabels() const;

戻り値

TRUE 画像の下にテキストラベルを表示することが許可されている場合。それ以外の場合 FALSEは .

解説

このメソッドは、選択したツール バーの [ツール バー] ページで [テキスト ラベルの表示] チェックボックスを有効にするかどうかを決定するために、カスタマイズ ダイアログ ボックスによって呼び出されます。

既定の実装では、TRUE が返されます。

ユーザーがイメージの下のツール バー ボタンにテキスト ラベルを表示するかどうかを決定しない場合は、派生 CMFCToolBar オブジェクトでこのメソッドをオーバーライドして返 FALSE します。

CMFCToolBar::AllowShowOnList

[カスタマイズ] ダイアログ ボックスの [ツール バー] ウィンドウのツール バーの一覧にツール バーを表示するかどうかを指定します。

virtual BOOL AllowShowOnList() const;

戻り値

TRUE ツールバーのカスタマイズ ページのリスト ボックスにツール バー オブジェクトを表示できる場合。それ以外の場合 FALSEは .

解説

このメソッドは、ツール バーのカスタマイズ ページのリストに派生した特定のオブジェクトを含める必要があるかどうかを判断するために、フレームワークによって呼び出されます CMFCToolBar。

既定の実装では、常に TRUE を返します。 カスタマイズ ダイアログ ボックスのツール バーの一覧にツール バーを表示しない場合は、このメソッドをオーバーライドします。

CMFCToolBar::AreTextLabels

イメージの下のテキスト ラベルをツール バー ボタンに現在表示するかどうかを指定します。

BOOL AreTextLabels() const;

戻り値

TRUE ツールバーボタンが画像の下にテキストラベルを表示する場合。それ以外の場合 FALSEは .

解説

テキストを表示するかどうかを指定するために使用 CMFCToolBar::EnableTextLabels します。 既定値は FALSE です。 ユーザーがカスタマイズ ダイアログ ボックスでこの設定を変更できるかどうかを指定する呼び出し CMFCToolBar::AllowChangeTextLabels 。

CMFCToolBar::AutoGrayInactiveImages

非アクティブなボタン イメージの自動生成を有効または無効にします。

static void AutoGrayInactiveImages(
    BOOL bEnable=TRUE,
    int nGrayImagePercentage=0,
    BOOL bRedrawAllToolbars=TRUE);

パラメーター

bEnable
[in]非アクティブなイメージを暗くするかどうかを指定するブール値。 このパラメーターを指定 TRUEすると、非アクティブなイメージは淡色表示されます。 それ以外の場合、非アクティブなイメージは淡色表示されません。

nGrayImagePercentage
[in]非アクティブなイメージの輝度の割合を指定します。 指定したFALSE場合bEnable、この値は無視されます。

bRedrawAllToolbars
[in]アプリケーション内のすべてのツール バーを再描画するかどうかを指定するブール値。 このパラメーターが指定されている TRUE場合、このメソッドはすべてのツール バーを再描画します。

解説

ある場合 bEnable 、 TRUEフレームワークは通常のイメージから非アクティブなイメージを生成するために使用 nGrayImagePercentage します。 それ以外の場合は、メソッドを使用して非アクティブなイメージのセットを指定する CMFCToolBar::GetColdImages 必要があります。 既定では、このオプションは無効になっています。

nGrayImagePercentage パラメーターの詳細については、「CMFCToolBarImages::GrayImages」を参照してください。

CMFCToolBar::ButtonToIndex

このツール バーの指定した CMFCToolBarButton Class オブジェクトのインデックスを返します。

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

パラメーター

pButton
[in]ツール バー ボタン オブジェクトへのポインター。

戻り値

ツール バー ボタンの pButton 内部リスト内のインデックス。指定したボタンがこのツール バーにない場合は -1。

CMFCToolBar::CalcFixedLayout

ツール バーの水平方向のサイズを計算します。

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

パラメーター

bStretch
[in] TRUE をクリックして、ツールバーを親フレームのサイズに拡大します。

bHorz
[in] TRUE ツールバーを水平方向に向ける場合。 FALSE をクリックして、ツールバーを垂直方向に向けます。

戻り値

CSizeツール バーのサイズを指定するオブジェクト。

解説

このメソッドは、メソッドを使用してツール バーのサイズを CMFCToolBar::CalcLayout 計算します。 パラメーターのフラグをLM_STRETCH渡します (bStretchif は TRUE.dwMode 次の場合bHorzTRUEはフラグをLM_HORZ渡します。

このメソッドを使用する例については、VisualStudioDemo サンプルを参照してください。

CMFCToolBar::CalcMaxButtonHeight

ツール バーのボタンの最大高さを計算します。

virtual int CalcMaxButtonHeight();

戻り値

ボタンの最大高さ。

解説

このメソッドは、ツールバー上のすべてのツールバー ボタンの最大高さを計算します。 高さは、現在のツール バーのドッキング状態などの要因によって異なる場合があります。

独自の高さの計算を提供するために、派生クラス CMFCToolBar でこのメソッドをオーバーライドします。

CMFCToolBar::CalcSize

レイアウト計算プロセスの一部としてフレームワークによって呼び出されます。

virtual CSize CalcSize(BOOL bVertDock);

パラメーター

bVertDock
[in] TRUE ツールバーを垂直方向にドッキングすることを指定する場合は >。 FALSE ツールバーを水平方向にドッキングするように指定します。

戻り値

CSizeツール バーのボタンの全体的なサイズを指定するオブジェクト。

解説

このメソッドは、テキスト ラベルの領域や境界線のサイズなど、各ボタンのサイズに影響する属性を考慮します。

ツール バーにボタンが含まれている場合、このメソッドはメソッドを使用して 1 つのボタンの予約済みサイズを CMFCToolBar::GetButtonSize 返します。

CMFCToolBar::CanBeClosed

ユーザーがツール バーを閉じることができるかどうかを指定します。

virtual BOOL CanBeClosed() const;

戻り値

TRUE ツールバーをユーザーが閉じることができる場合。それ以外の場合 FALSEは .

解説

フレームワークは、このメソッドを呼び出して、ユーザーがツール バーを閉じることができるかどうかを判断します。 メソッドから制御が戻ったTRUE場合、フレームワークはツール バーのシステム メニューでコマンドを有効にSC_CLOSEし、ユーザーはカスタマイズ ダイアログ ボックスのツール バーの一覧のチェック ボックスを使用してツール バーを閉じます。

既定の実装では、TRUE が返されます。 ユーザーが閉じることができないツール バー オブジェクトを作成するには、派生 CMFCToolBar クラスでこのメソッドをオーバーライドします。

CMFCToolBar::CanBeRestored

カスタマイズ後にツール バーを元の状態に戻すことができるかどうかを判断します。

virtual BOOL CanBeRestored() const;

戻り値

TRUE ツール バーをアプリケーション リソースから復元できる場合。それ以外の場合 FALSEは .

解説

フレームワークは、このメソッドを呼び出して、カスタマイズ後にツール バーを元の状態に戻すことができるかどうかを判断します。 元の状態は、アプリケーション リソースから読み込まれます。

戻った場合CanBeRestored、カスタマイズ ダイアログ ボックスの [ツール バー] ページで、選択したツール バーの [リセット] ボタンTRUEが有効になります。

既定の実装では、 TRUE 読み込まれたツール バーの元のリソース ID が 0 以外の場合に返されます。 通常、復元できるのはユーザー定義ツール バーのみです。

メソッドを CanBeRestored オーバーライドして、派生クラスでこの動作をカスタマイズできます。

CMFCToolBar::CanFocus

ウィンドウがフォーカスを受け取ることができるかどうかを指定します。

virtual BOOL CanFocus() const;

戻り値

このメソッドが返します FALSE。

解説

ツール バー オブジェクトはフォーカスを受け取ることができないため、 CBasePane::CanFocusこのメソッドは基底クラスの実装をオーバーライドします。

CMFCToolBar::CanHandleSiblings

ツール バーとその兄弟が同じウィンドウに配置されているかどうかを判定します。

BOOL CanHandleSiblings();

戻り値

TRUE ツールバーに兄弟があり、そのツールバーとその兄弟が同じペインに配置されている場合。それ以外の場合 FALSEは .

解説

内部CMFCCustomizeButton::CreatePopupMenuメソッドは、このメソッドを呼び出して、[カスタマイズ] ポップアップ メニューの表示方法を決定します。 このメソッドが返されたTRUE場合、フレームワークは、1 つの行にボタンを表示または 2 行のボタンを表示するボタンを表示します。

通常、このメソッドを使用する必要はありません。 ツール バーに表示される [カスタマイズ] ボタンを有効にするには、メソッドをCMFCToolBar::EnableCustomizeButton呼び出します。 [1 行のボタンの表示] または [2 つの行] ボタンの [ボタンの表示] を有効にするには、 を呼び出しますCMFCToolBar::SetSiblingToolBar。

CMFCToolBar::CleanUpImages

ツール バー イメージに割り当てられたシステム リソースを解放します。

static void CMFCToolBar::CleanUpImages();

解説

フレームワークは、アプリケーションのシャットダウン時にこのメソッドを呼び出します。

CMFCToolBar::CleanUpLockedImages

ロックされたツール バー イメージに割り当てられたシステム リソースを解放します。

void CleanUpLockedImages();

解説

アプリケーションのビジュアル スタイルが変更されたときに、このメソッドを呼び出します。 このメソッドを使用する例については、VisualStudioDemo サンプルを参照してください。

CMFCToolBar::CommandToIndex

指定したコマンド ID を持つツール バーのボタンのインデックスを返します。

int CommandToIndex(
    UINT nIDFind,
    int iIndexFirst=0) const;

パラメーター

nIDFind
[in]コマンド ID を指定します。

iIndexFirst
[in]開始する最初のインデックスを指定します。

戻り値

メソッドが成功した場合のツール バー ボタンの 0 から始まるインデックス。指定した ID のボタンがない場合は -1。

解説

CMFCToolBarオブジェクトメインツールバーのボタンの内部リストが含まれます。 この関数を呼び出して、ボタンのコマンド ID を指定してリスト内のボタンのインデックスを取得します。

0 より大きい場合 iIndex 、このメソッドは、インデックスが 0 より小さい iIndexツール バー上のボタンを無視します。

CMFCToolBar::Create

CMFCToolBar オブジェクトを作成します。

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT nID=AFX_IDW_TOOLBAR);

パラメーター

pParentWnd
[in]ツール バーの親ウィンドウへのポインター。

dwStyle
[in]ツール バーのスタイル。 スタイルの一覧については、Windows SDK のツール バー コントロールとボタン のスタイルに関するページを参照してください。

nID
[in]ツール バーの子ウィンドウの ID。

戻り値

TRUE このメソッドが成功した場合。それ以外の場合 FALSEは .

解説

このメソッドは、コントロール バーを作成し、ツール バーにアタッチします。 TB (テラバイト)STYLE_FLAT スタイルのコントロール バーが作成されます。 別のコントロール バー スタイルが必要な場合に呼び出 CMFCToolBar::CreateEx します。

CMFCToolBar::CreateEx

CMFCToolBar大きなアイコンなどの追加のスタイル オプションを使用するオブジェクトを作成します。

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=TBSTYLE_FLAT,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    CRect rcBorders=CRect(1,
    1,
    1,
    1),
    UINT nID=AFX_IDW_TOOLBAR);

パラメーター

pParentWnd
[in]ツール バーの親ウィンドウへのポインター。

dwCtrlStyle
[in]埋め込みコントロール バー オブジェクトを作成するための追加のスタイル。

dwStyle
[in]ツール バーのスタイル。 適切なスタイルの一覧については、「ツールバー コントロールとボタンのスタイル」を参照してください。

rcBorders
[in] CRect ツール バー ウィンドウの境界線の幅を指定するオブジェクト。

nID
[in]ツール バーの子ウィンドウの ID。

戻り値

このメソッドが成功した場合は 0 以外。それ以外の場合は 0。

解説

このメソッドは、コントロール バーを作成し、ツール バーにアタッチします。

特定のスタイルを指定する場合ではなく CMFCToolBar::Create 、このメソッドを呼び出します。 たとえば、インターネット エクスプローラー 4 で使用されるツール バーに似たツール バーを作成するようにTBSTYLE_FLAT | TBSTYLE_TRANSPARENT設定dwCtrlStyleします。

例

次の例では、クラスのメソッドを使用する CreateEx 方法を CMFCToolBar 示します。 このコード スニペットは、IE デモ サンプルの一部です。

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

CMFCToolBar::Deactivate

ツール バーを非アクティブ化します。

virtual void Deactivate();

解説

このメソッドは、強調表示されているツール バー ボタンからフォーカスを削除することで、ツール バーを非アクティブ化します。 フレームワークは、ツール バーがフォーカスを失うか破棄されたときに、このメソッドを呼び出します。

CMFCToolBar::DoPaint

ツール バーを再描画します。

virtual void DoPaint(CDC* pDC);

パラメーター

pDC
[入力] デバイス コンテキストへのポインター。

解説

このメソッドは、ツール バーの一部を再描画する必要がある場合に、フレームワークによって呼び出されます。

このメソッドをオーバーライドして、派生 CMFCToolBarオブジェクトの外観をカスタマイズします。

CMFCToolBar::DrawButton

ツール バー ボタンを再描画します。

virtual BOOL DrawButton(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CMFCToolBarImages* pImages,
    BOOL bHighlighted,
    BOOL bDrawDisabledImages);

パラメーター

pDC
[入力] デバイス コンテキストへのポインター。

pButton
[in]描画するボタンへのポインター。

pImages
[in]ツール バーイメージへのポインター。

bHighlighted
[in] TRUE ボタンが強調表示されている場合。それ以外の場合 FALSEは .

bDrawDisabledImages
[in] TRUE 無効なボタンが淡色表示の場合。それ以外の場合 FALSEは .

戻り値

TRUE ボタンが再描画された場合。 FALSE ボタンが非表示の場合は 。

解説

このメソッドは CMFCToolBar::DrawButton 、ツール バー ボタンを再描画する必要がある場合に、このメソッドを呼び出します。

ツール バーのボタンの外観をカスタマイズする場合は、このメソッドをオーバーライドします。

CMFCToolBar::DrawSeparator

ツールバーの区切り記号を再描画します。

virtual void DrawSeparator(
    CDC* pDC,
    const CRect& rect,
    BOOL bHorz);

パラメーター

pDC
[入力] デバイス コンテキストへのポインター。

rect
[in]区切り記号が描画される位置の外接する四角形 (ピクセル単位)。

bHorz
[in] TRUE 区切り記号が垂直の場合は、 FALSE 区切り記号が水平の場合。

解説

CMFCToolBar::DoPaintは、これらのボタンを呼び出すのではなく、スタイルをTBBS_SEPARATOR持つオブジェクトごとにCMFCToolBar::DrawSeparatorこのメソッドを呼び出CMFCToolBar::DrawButtonします。

ツール バーの区切り記号の外観をカスタマイズするには、派生 CMFCToolBar クラスでこのメソッドをオーバーライドします。 既定の実装では、現在のビジュアル マネージャーによって外観が決定される区切り記号を描画する呼び出し CMFCVisualManager::OnDrawSeparator です。

CMFCToolBar::EnableCustomizeButton

ツール バーに表示される [カスタマイズ] ボタンを有効または無効にします。

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    const CString& strCustomizeText,
    BOOL bQuickCustomize=TRUE);

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    UINT uiCustomizeTextResId,
    BOOL bQuickCustomize=TRUE);

パラメーター

bEnable
[in][カスタマイズ] ボタンを有効または無効にします。

iCustomizeCmd
[in][カスタマイズ] ボタンのコマンド ID。

strCustomizeText
[in][カスタマイズ] ボタンのテキスト ラベル。

uiCustomizeTextResId
[in][カスタマイズ] ボタン ラベルのリソース文字列 ID。

bQuickCustomize
[in]ボタンからドロップダウンするメニューの [ボタンの追加と削除] オプションを有効または無効にします。

解説

-1 の場合 iCustomizeCmd 、ツール バー領域に複数のツール バー ボタンが収まらない場合、フレームワークによって [カスタマイズ] ボタンが表示されます。 ボタンには、ボタンが他にもあることを示す二重左向きの矢印 (シェブロン) が表示されます。

有効なコマンド ID を指定しbEnable、有効な場合iCustomizeCmdはTRUE、[カスタマイズ] ボタンが常に表示されます。 ボタンには小さな下向き矢印があり、コマンドを含むメニューが開きます。 このコマンドでは、次で指定されたテキスト ラベルを strCustomizeText使用します。 そのTRUE場合bQuickCustomizeは、メニューに [ボタンの追加と削除] オプションが表示されます。

フレームワークは、メニューにツール バー領域に収まらないボタンを、指定された iCustomizeCmd項目の前に動的に追加します。 下矢印の横にシェブロンが表示されます。

CMFCToolBar::EnableDocking

ウィンドウのメイン フレームへのドッキングを有効にします。

virtual void EnableDocking(DWORD dwAlignment);

パラメーター

dwAlignment
[入力] 有効にするドッキング配置が指定されます。

解説

このメソッドは、データ メンバーを 〘 に設定することで、 CBasePane::EnableDocking基底クラスの実装を CBasePane::m_dwControlBarStyle 拡張します AFX_CBRS_FLOAT。 このメソッドは、基底クラスの dwAlignment 実装に渡されます。

CMFCToolBar::EnableLargeIcons

ツール バー ボタンの大きなアイコンを有効または無効にします。

void EnableLargeIcons(BOOL bEnable);

パラメーター

bEnable
[in] TRUE をクリックして大きなアイコンを有効にし、 FALSE 大きなアイコンを無効にします。

解説

既定では、大きなアイコンが有効になっています。

CMFCToolBar::EnableQuickCustomization

ユーザーが Alt キーを押してボタンを新しい場所にドラッグできるように、ツール バーのクイック カスタマイズを有効または無効にします。

static void EnableQuickCustomization(BOOL bEnable=TRUE);

パラメーター

bEnable
[in] TRUE クイックカスタマイズを有効にし、 FALSE クイックカスタマイズを無効にします。

CMFCToolBar::EnableReflections

コマンド リフレクションを有効または無効にします。

void EnableReflections(BOOL bEnable = TRUE);

パラメーター

bEnable
[in] TRUE コマンドリフレクションを有効にするには、 FALSE コマンド リフレクションを無効にします。

解説

コンボ ボックスなどの埋め込みコントロールを含むツール バー ボタンのコマンド リフレクションを有効にするには、このメソッドを呼び出します。

コマンド リフレクションの詳細については、「TN062: Windows コントロールのメッセージリフレクトion」を参照してください。

CMFCToolBar::EnableTextLabels

ツール バー ボタンの画像の下にあるテキスト ラベルを有効または無効にします。

void EnableTextLabels(BOOL bEnable=TRUE);

パラメーター

bEnable
TRUE テキストラベルがツールバーボタンの画像の下に表示される場合。それ以外の場合 FALSEは .

解説

テキスト ラベルが有効になっている場合は、ツール バーのすべてのボタンが拡大され、画像の下にラベルを表示するためのスペースが提供されます。 [カスタマイズ] ダイアログ ボックスの [ツール バー] ページの [テキスト ラベルの表示] チェックボックスが表示されます。 ユーザーがツール バーを選択し、このオプションをチェックすると、フレームワークは選択したツール バーを呼び出EnableTextLabelsします。 から戻ることで、派生CMFCToolBarオブジェクトのチェックボックスをFALSECMFCToolBar::AllowChangeTextLabels 無効にすることができます。

CMFCToolBar::FromHandlePermanent

指定されたウィンドウ ハンドルを CMFCToolBar 含むオブジェクトへのポインターを取得します。

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

パラメーター

hwnd
[in]検索するウィンドウ ハンドル。

戻り値

指定されたウィンドウ ハンドルを CMFCToolBar 含むオブジェクトへのポインター、または NULL 対応する CMFCToolBar オブジェクトが存在しない場合。

解説

この共有メソッドは、アプリケーション内の各ツール バーで、指定されたウィンドウ ハンドルを CMFCToolBar 含むオブジェクトを調べます。

CMFCToolBar::GetAllButtons

ツール バーのボタンの読み取り専用リストを返します。

const CObList& GetAllButtons() const;

戻り値

クラス オブジェクトのコレクションCMFCToolBarButtonをCObList含むクラス オブジェクトへの定数参照。

CMFCToolBar::GetAllToolbars

アプリケーション内のすべてのツール バーの読み取り専用リストを返します。

static const CObList& GetAllToolbars();

戻り値

オブジェクトのコレクションCMFCToolBarをCObList含む Class オブジェクトへの const 参照。

CMFCToolBar::GetBasicCommands

アプリケーションで定義されている基本コマンドの読み取り専用リストを返します。

static const CList<UINT,UINT>& GetBasicCommands();

戻り値

基本コマンドのコレクションを CList 含む Class オブジェクトへの const 参照。

解説

を呼び出 CMFCToolBar::AddBasicCommand して基本的なコマンドを追加します CMFCToolBar::SetBasicCommands。

CMFCToolBar::GetButton

指定したインデックス位置にある CMFCToolBarButton Class オブジェクトへのポインターを返します。

CMFCToolBarButton* GetButton(int iIndex) const;

パラメーター

iIndex
[in]返すボタンのインデックスを指定します。

戻り値

ツール バー ボタン (存在する場合) へのポインター。または NULL 、そのようなボタンがない場合。

CMFCToolBar::GetButtonInfo

指定したインデックス位置にあるボタンのコマンド ID、スタイル、およびイメージ インデックスを返します。

void GetButtonInfo(
    int nIndex,
    UINT& nID,
    UINT& nStyle,
    int& iImage) const;

パラメーター

nIndex
[in]ツール バーのボタンの一覧にあるボタンのインデックスを指定します。

nID
[out]ボタンのコマンド ID。

nStyle
[out]ボタンのスタイル。

iImage
[out]ボタンのイメージのインデックス。

解説

このメソッドは GetButtonInfo 、指定したインデックス位置にあるツール バー ボタンを検索し、ボタンのコマンド ID、スタイル、およびイメージ インデックスを取得します。

指定したインデックス位置にあるボタンが存在しない場合、フレームワークは 0 に設定されnStyleiImage、メソッドが戻るときに -1 に設定nIDされます。

CMFCToolBar::GetButtonSize

ツール バーの各ボタンの寸法を返します。

CSize GetButtonSize() const;

戻り値

CSizeツール バーの各ボタンの寸法を指定する Class オブジェクト。

解説

ツール バーの各ボタンの寸法を設定またはCMFCToolBar::SetLockedSizes呼び出CMFCToolBar::SetSizesします。

CMFCToolBar::GetButtonStyle

指定したインデックス位置にあるツール バー ボタンの現在のスタイルを返します。

UINT GetButtonStyle(int nIndex) const;

パラメーター

nIndex
[in]ツール バー ボタンのインデックスを指定します。

戻り値

ツール バー ボタンのスタイルを指定する値。 . 使用可能なスタイルの一覧については、「ToolBar コントロールのスタイル」を参照してください。

解説

ツール バー ボタンのスタイルを設定する呼び出しCMFCToolBar::SetButtonStyle

CMFCToolBar::GetButtonText

指定したインデックスを持つボタンのテキスト ラベルを返します。

CString GetButtonText(int nIndex) const;

void GetButtonText(
    int nIndex,
    CString& rString) const;

パラメーター

nIndex
[in]ツール バー ボタンのインデックス。

rString
[out]ツール バー ボタンのラベル テキスト。

戻り値

ツール バー ボタンのラベル テキスト。

解説

テキスト ラベルを呼び出 CMFCToolBar::SetButtonText すか CMFCToolBar::SetToolBarBtnText 設定します。

CMFCToolBar::GetColdImages

アプリケーションのコールド ツール バー ボタン イメージのコレクションへのポインターを返します。

static CMFCToolBarImages* GetColdImages();

戻り値

コールド ツール バー ボタンイメージのコレクションへのポインター。

解説

コールド イメージは、ユーザーがツール バー ボタンを操作していない場合に使用されるイメージです。 コールド イメージを呼び出 CMFCToolBar::LoadBitmapEx すか CMFCToolBar::LoadBitmap 読み込みます。

CMFCToolBar::GetColumnWidth

ツール バー ボタンの幅を返します。

virtual int GetColumnWidth() const;

戻り値

ツール バー ボタンの幅を指定する値。

解説

フレームワークはこのメソッドを呼び出して、ツール バーのレイアウトを計算します。 派生クラスでこのメソッドをオーバーライドして、ツール バーに別の列幅を指定します。

CMFCToolBar::GetCommandButtons

指定したコマンド ID を持つボタンの一覧を、アプリケーション内のすべてのツール バーから返します。

static int GetCommandButtons(
    UINT uiCmd,
    CObList& listButtons);

パラメーター

uiCmd
[in]ボタンのコマンド ID。

listButtons
[out]ツール バー ボタンの CObList 一覧を受け取る Class オブジェクトへの参照。

戻り値

指定したコマンド ID を持つボタンの数。

CMFCToolBar::GetCount

ツール バーのボタンと区切り記号の数を返します。

int GetCount() const;

戻り値

ツール バーのボタンと区切り記号の数。

CMFCToolBar::GetCustomizeButton

ツール バーに関連付けられているオブジェクトへの CMFCCustomizeButton ポインターを取得します。

CMFCCustomizeButton* GetCustomizeButton();

戻り値

ツール バーに CMFCCustomizeButton 関連付けられているオブジェクトへのポインター。

解説

このメソッドは、ツール バーの 末尾に表示される [カスタマイズ ] ボタンを取得します。 ツール バーに CMFCToolBar::EnableCustomizeButton [カスタマイズ] ボタンを追加するには、このメソッドを使用します。

このメソッドを CMFCToolBar::IsExistCustomizeButton 呼び出して、ツール バーに有効な CMFCCustomizeButton オブジェクトが含まれているかどうかを判断できます。

CMFCToolBar::GetDefaultImage

指定したコマンド ID を持つツール バー ボタンの既定のイメージのインデックスを返します。

static int GetDefaultImage(UINT uiID);

パラメーター

uiID
[in]ボタンのコマンド ID を指定します。

戻り値

イメージの共有リスト内のツール バー イメージのインデックス。

解説

この共有メソッドを使用して、指定したコマンド ID を持つツール バー ボタンの既定のイメージのインデックスを取得します。 戻り値は、アプリケーション内のすべてのツール バーのツール バー ボタン イメージの共有コレクションへのインデックスです。 メソッドを CMFCToolBar::GetImages 呼び出して、このコレクションへのポインターを取得します。

CMFCToolBar::GetDisabledImages

アプリケーションで無効になっているツール バー ボタンに使用されるイメージのコレクションへのポインターを返します。

static CMFCToolBarImages* __stdcall GetDisabledImages();

戻り値

無効なツール バー ボタンイメージのコレクションへのポインター。

解説

クラスとCMFCToolBar::LoadBitmapメソッドを使用して、無効になっているツール バー ボタンの画像をCMFCToolBarEditBoxButton読み込みます。

CMFCToolBar::GetDisabledMenuImages

アプリケーションで無効になっているメニュー ボタンに使用されるイメージのコレクションへのポインターを返します。

static CMFCToolBarImages* __stdcall GetDisabledMenuImages();

戻り値

無効なメニュー イメージのコレクションへのポインター。

解説

Class メソッドを使用して、無効なイメージをCMFCToolBarEditBoxButton読み込みます。

CMFCToolBar::GetDroppedDownMenu

現在サブメニューを表示しているメニュー ボタン オブジェクトへのポインターを取得します。

CMFCToolBarMenuButton* GetDroppedDownMenu(int* pIndex = NULL) const;

パラメーター

pIndex
[out]ツール バー ボタンのコレクション内のボタンのインデックスを受け取ります。

戻り値

サブメニューを表示しているメニュー ボタン オブジェクトへのポインター、または NULL メニューにサブメニューが表示されていない場合。

解説

このメソッドが null 以外の値を返す pIndex 場合、 NULL指す pIndex 値はツールバー ボタンのコレクション内のメニュー ボタンのインデックスに設定されます。

CMFCToolBar::GetGrayDisabledButtons

無効なボタンのイメージを通常のボタン イメージの淡色表示バージョンにするか、無効なボタンイメージのコレクションから取得するかを指定します。

BOOL GetGrayDisabledButtons() const;

戻り値

TRUE 無効なボタンの画像を暗くする場合。 FALSE 無効なイメージのコレクションからイメージを取得します。

解説

淡色表示されたイメージと、無効なイメージのコレクションからイメージを切り替える場合に使用 CMFCToolBar::SetGrayDisabledButtons します。

CMFCToolBar::GetHighlightedButton

現在強調表示されているツール バー ボタンへのポインターを返します。

CMFCToolBarButton* GetHighlightedButton() const;

戻り値

ツール バー ボタン オブジェクトへのポインター。または NULL 、ボタンが強調表示されていない場合。

解説

キーボード フォーカスがある場合、ツール バー ボタンが強調表示されます。 ツール バー ボタンは、このアプリケーションでツール バー ボタンがホット トラックされている場合にも強調表示されます (詳細については、参照 CMFCToolBar::GetHotBorder してください)。 CMFCToolBar::SetHotBorderまた、ツール バー ボタンまたはメニュー項目にキーボード フォーカスがないときにマウスがポイントされている場合です。

CMFCToolBar::GetHotBorder

ツール バー ボタン をホット トラックするかどうかを指定します。 ボタンがホット トラックされている場合は、マウスが移動したときに強調表示されます。

BOOL GetHotBorder() const;

戻り値

TRUEツール バー ボタンがホット トラックされている場合。それ以外の場合は . FALSE

解説

既定では、ツール バー ボタンはホット トラックされます。

CMFCToolBar::GetHotTextColor

強調表示されているツール バー ボタンのテキストの色を返します。

static COLORREF GetHotTextColor();

戻り値

COLORREF現在強調表示されているテキストの色を表す値。

解説

強調表示されたツール バー ボタンの新しいテキストの色を設定する呼び出し CMFCToolBar::SetHotTextColor 。

CMFCToolBar::GetHwndLastFocus

ツール バーの直前に入力フォーカスがあるウィンドウへのハンドルを返します。

HWND GetHwndLastFocus() const;

戻り値

以前に入力フォーカスを持っていたクラスからCMFCBaseToolBar派生していないウィンドウへのハンドル。またはNULLそのようなウィンドウがない場合。

解説

コントロールは CMFCToolBar 、入力フォーカスを受け取ると、フォーカスを失ったウィンドウへのハンドルを格納して、後で復元できるようにします。

CMFCToolBar::GetIgnoreSetText

ボタン ラベルを設定する呼び出しを無視するかどうかを指定します。

BOOL GetIgnoreSetText() const;

戻り値

TRUEボタン ラベルを設定する呼び出しが無視される場合。それ以外の場合は . FALSE

解説

CMFCToolBar::GetImages

アプリケーション内の既定のボタン イメージのコレクションへのポインターを返します。

static CMFCToolBarImages* GetImages();

戻り値

アプリケーション内のすべてのツール バーの既定のイメージのコレクションを含む Class オブジェクトへのポインター。CMFCToolBarImages

解説

この共有メソッドは、アプリケーションのすべての既定のツール バー イメージのコレクションへのアクセスを提供します。 メソッドを CMFCToolBar::LoadBitmap 呼び出して、コレクションにイメージを追加します。

CMFCToolBar::GetImageSize

ツール バー ボタンイメージの現在のサイズを返します。

CSize GetImageSize() const;

戻り値

CSizeツール バー ボタンのイメージの現在のサイズを表す Class オブジェクト。

CMFCToolBar::GetImagesOffset

ツール バー ボタン イメージのグローバル リストで、このツール バーのツール バー ボタンイメージを検索するために使用されるインデックス オフセットを返します。

int GetImagesOffset() const;

戻り値

ツール バー イメージのインデックス オフセット。

解説

すべてのツール バーの既定のイメージは、グローバル CMFCToolBarImages クラス の一覧に格納されます。 ツール バーの各ボタンの画像は、その一覧に連続して格納されます。 イメージのインデックスを計算するには、ツール バーのボタンのインデックスを、そのツール バー ボタンの画像リストの先頭のオフセットに追加します。

ボタンへのポインターを指定して、ツール バー ボタンのインデックスを取得する呼び出 CMFCToolBar::ButtonToIndex し。

ツール バー イメージのコレクションへのポインターを取得する呼び出し CMFCToolBar::GetImages 。

CMFCToolBar::GetInvalidateItemRect

指定したインデックス位置にあるボタンに対して再描画する必要があるクライアント領域の領域を取得します。

virtual void GetInvalidateItemRect(
    int nIndex,
    LPRECT lpRect) const;

パラメーター

nIndex
[in]クライアント領域を取得するボタンのインデックス。

lpRect
[out]クライアント領域の領域を RECT 受け取るオブジェクトへのポインター。

解説

パラメーターを lpRect 指定することはできません NULL。 指定されたインデックスにボタンが存在しない場合は、 lpRect 0 に初期化されたオブジェクトを受け取ります RECT 。

CMFCToolBar::GetItemID

指定したインデックス位置にあるツール バー ボタンのコマンド ID を返します。

UINT GetItemID(int nIndex) const;

パラメーター

nIndex
[in]ツール バー ボタンのインデックスを指定します。

戻り値

ツール バー ボタンのコマンド ID。指定したインデックスを持つボタンが存在しない場合は 0。

CMFCToolBar::GetItemRect

指定したインデックス位置にあるボタンの外接する四角形を返します。

virtual void GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

パラメーター

nIndex
[in]ツール バー ボタンのインデックスを指定します。

lpRect
[out]画像の外接する四角形の座標を受け取るオブジェクトへの CRect ポインター。

解説

CRect指定したインデックス位置にあるlpRectボタンが存在しない場合、ポイント先のオブジェクトは 0 に設定されます。

例

次の例では、クラスのメソッドを使用する GetItemRect 方法を CMFCToolBar 示します。 このコード スニペットは、IE デモ サンプルの一部です。

CMFCToolBar m_wndToolBar;

CRect rectToolBar;
m_wndToolBar.GetItemRect(0, &rectToolBar);

CMFCToolBar::GetLargeColdImages

アプリケーション内の大きなコールド ツール バー ボタン イメージのコレクションへのポインターを返します。

static CMFCToolBarImages* GetLargeColdImages();

戻り値

大きなコールド イメージのコレクションへのポインター。

解説

コールド イメージは、ユーザーがツール バー ボタンを操作していない場合に使用されるイメージです。 大きなコールド イメージを読み込む呼び出し CMFCToolBar::LoadBitmapEx 。

CMFCToolBar::GetLargeDisabledImages

アプリケーションで無効になっている大きなツール バー ボタンイメージのコレクションへのポインターを返します。

static CMFCToolBarImages* GetLargeDisabledImages();

戻り値

無効になっている大きなツール バー ボタンイメージのコレクションへのポインター。

解説

大きなイメージは、通常のツール バー ボタンイメージの大きなバージョンです。 大きなイメージを呼び出 CMFCToolBar::LoadBitmapEx すか CMFCToolBar::LoadBitmap 、読み込みます。

CMFCToolBar::GetLargeImages

アプリケーション内の大きなツール バー ボタンイメージのコレクションへのポインターを返します。

static CMFCToolBarImages* GetLargeImages();

戻り値

大きなツール バー ボタンイメージのコレクションへのポインター。

解説

大きなイメージは、通常のツール バー ボタンイメージの大きなバージョンです。 大きなイメージを読み込む呼び出し CMFCToolBar::LoadBitmapEx 。

CMFCToolBar::GetLockedColdImages

ツール バーのロックされたコールド イメージのコレクションへのポインターを返します。

CMFCToolBarImages* GetLockedColdImages();

戻り値

ロックされたコールド イメージのコレクションへのポインター、または NULL ツール バーがロックされていない場合。

解説

ロックされたイメージは、ユーザーがツール バーをカスタマイズできない場合にフレームワークが使用する通常のツール バー ボタン イメージのバージョンです。 コールド イメージは、ユーザーがツール バー ボタンを操作していない場合に使用されるイメージです。

このメソッドは、 NULL ツール バーがロックされていない場合に返します。 このメソッドは、ツール バーがロックされていない場合、デバッグ ビルドでアサーション エラーも生成します。 ロックされたツール バーの詳細については、次を参照してください CMFCToolBar::IsLocked。

ロックされた CMFCToolBar::LoadBitmapEx コールド イメージを読み込むには、メソッドを呼び出します。

CMFCToolBar::GetLockedDisabledImages

ツール バーのロックされた無効なイメージのコレクションへのポインターを返します。

CMFCToolBarImages* GetLockedDisabledImages();

戻り値

ロックされた無効なイメージのコレクションへのポインター、または NULL ツール バーがロックされていない場合。

解説

ロックされたイメージは、ユーザーがツール バーをカスタマイズできない場合にフレームワークが使用する通常のツール バー ボタン イメージのバージョンです。 無効なイメージは、ボタンにスタイルがある場合にフレームワークが使用する TBBS_DISABLED イメージです。

このメソッドは、 NULL ツール バーがロックされていない場合に返します。 このメソッドは、ツール バーがロックされていない場合、デバッグ ビルドでアサーション エラーも生成します。 ロックされたツール バーの詳細については、次を参照してください CMFCToolBar::IsLocked。

ロックされた無効な CMFCToolBar::LoadBitmapEx イメージを読み込むには、メソッドを呼び出します。

CMFCToolBar::GetLockedImages

ツール バーのロックされたボタン イメージのコレクションへのポインターを返します。

CMFCToolBarImages* GetLockedImages();

戻り値

ロックされたツール バー ボタンイメージのコレクションへのポインター、または NULL ツールバーがロックされていない場合。

解説

ロックされたイメージは、ユーザーがツール バーをカスタマイズできない場合にフレームワークが使用する通常のツール バー ボタン イメージのバージョンです。

このメソッドは、 NULL ツール バーがロックされていない場合に返します。 このメソッドは、ツール バーがロックされていない場合、デバッグ ビルドでアサーション エラーも生成します。 ロックされたツール バーの詳細については、次を参照してください CMFCToolBar::IsLocked。

CMFCToolBar::GetLockedImageSize

ロックされているツール バー イメージの既定のサイズを返します。

CSize GetLockedImageSize() const;

戻り値

CSizeロックされたツール バー イメージのサイズを指定する構造体、またはツール バーがロックされていない場合は空CSizeの構造体。

解説

ロックされたイメージは、ユーザーがツール バーをカスタマイズできない場合にフレームワークが使用する通常のツール バー ボタン イメージのバージョンです。

このメソッドは、ツールバーが CSize ロックされていない場合、幅が 0 で高さが 0 の構造体を返します。 このメソッドは、ツール バーがロックされていない場合、デバッグ ビルドでアサーション エラーも生成します。 ロックされたツール バーの詳細については、次を参照してください CMFCToolBar::IsLocked。

ロックされたイメージ サイズ CMFCToolBar::SetLockedSizes を指定するメソッドを呼び出します。

CMFCToolBar::GetLockedMenuImages

ツール バーのロックされたツール バー メニュー イメージのコレクションへのポインターを返します。

CMFCToolBarImages* GetLockedMenuImages();

戻り値

ロックされているツール バー メニュー イメージのコレクションへのポインター。または NULL ツール バーがロックされていない場合。

解説

ロックされたイメージは、ユーザーがツール バーをカスタマイズできない場合にフレームワークが使用する通常のツール バー メニュー イメージのバージョンです。

このメソッドは、 NULL ツール バーがロックされていない場合に返します。 このメソッドは、ツール バーがロックされていない場合、デバッグ ビルドでアサーション エラーも生成します。 ロックされたツール バーの詳細については、次を参照してください CMFCToolBar::IsLocked。

ロックされた CMFCToolBar::LoadBitmapEx メニュー イメージを読み込むには、メソッドを呼び出します。

CMFCToolBar::GetMenuButtonSize

アプリケーションのメニュー ボタンのサイズを返します。

static CSize GetMenuButtonSize();

戻り値

CSizeメニュー ボタンのサイズをピクセル単位で表すオブジェクト。

解説

ツール バーのメニュー ボタンのサイズはメイングローバル変数として格納され、この静的メソッドで取得できます。

このグローバル変数を設定する呼び出し CMFCToolBar::SetMenuSizes 。

CMFCToolBar::GetMenuImages

アプリケーション内のメニュー ボタン イメージのコレクションへのポインターを返します。

static CMFCToolBarImages* GetMenuImages();

戻り値

メニュー イメージのコレクションへのポインター。

解説

メソッドを CMFCToolBar::LoadBitmapEx 呼び出してメニュー イメージを読み込みます。

メソッドを CMFCToolBar::SetMenuSizes 呼び出して、ボタンとその画像のサイズを設定します。

CMFCToolBar::GetMenuImageSize

アプリケーション内のメニュー ボタンイメージのサイズを返します。

static CSize GetMenuImageSize();

戻り値

CSizeメニュー イメージのサイズを表すオブジェクト。

解説

このメソッドは、グローバル変数としてメイン含まれているツール バー メニュー ボタンの画像のサイズを返します。 このグローバル変数を設定する呼び出し CMFCToolBar::SetMenuSizes 。

CMFCToolBar::GetOrigButtons

ツール バーのカスタマイズされていないボタンのコレクションを取得します。

const CObList& GetOrigButtons() const;

戻り値

ツール バーのカスタマイズされていないボタンの一覧への参照。

解説

フレームワークは、ユーザーがカスタマイズする前に、ツール バー ボタンのコピーを作成します。 このメソッドは CMFCToolBar::SetButtons 、指定された配列内の各ボタンのコピーを元のボタンの一覧に追加します。 このメソッドは CMFCToolBar::RestoreOriginalState 、ツール バーをリソース ファイルから読み込むことで、元の状態を復元します。

ツール バーの元のボタンの一覧を設定するには、メソッドを CMFCToolBar::SetOrigButtons 呼び出します。

CMFCToolBar::GetOrigResetButtons

ツール バーのカスタマイズされていないリセット ボタンのコレクションを取得します。

const CObList& GetOrigResetButtons() const;

戻り値

ツール バーのカスタマイズされていないリセット ボタンの一覧への参照。

解説

ユーザーがカスタマイズ モード中に [リセット] ボタンを選択すると、フレームワークはこのメソッドを使用して、ツール バーから削除されたボタンを復元します。

メソッドは CMFCToolBar::SetButtons 、メソッドを呼び出した後、元のリセット ボタンの一覧に各ツール バー ボタンのコピーを CMFCToolBar::OnReset 追加します。 ユーザーが [リセット] ボタンをCMFCToolBar::OnReset押した後で、メソッドをオーバーライドしてボタンの外観をカスタマイズできます。

CMFCToolBar::GetResourceID

ツール バーのリソース ID を取得します。

UINT GetResourceID() const;

戻り値

ツール バーのリソース ID。

解説

ツール バーの CMFCToolBar::LoadToolBarEx リソース ID を設定するメソッドを呼び出します。

CMFCToolBar::GetRouteCommandsViaFrame

どのオブジェクト (親フレームまたは所有者) がツール バーにコマンドを送信するかを決定します。

BOOL GetRouteCommandsViaFrame();

戻り値

親フレームがツール バーにコマンドを送信する場合は 0 以外。所有者がツール バーにコマンドを送信する場合は 0。

解説

既定では、親フレームはツール バーにコマンドを送信します。 この動作を変更する呼び出し CMFCToolBar::SetRouteCommandsViaFrame 。

このメソッドが 0 以外の値を返す場合は、メソッドを使用して親フレーム オブジェクトへのポインターを CMFCToolBar::GetCommandTarget 取得できます。 このメソッドを使用する例については、VisualStudioDemo サンプルを参照してください。

CMFCToolBar::GetRowHeight

ツール バー ボタンの高さを返します。

virtual int GetRowHeight() const;

戻り値

ツールバー ボタンの高さ (ピクセル単位)。

解説

フレームワークはこのメソッドを呼び出して、ツール バーのレイアウトを計算します。 派生クラスでこのメソッドをオーバーライドして、ツール バーに別の高さを指定します。

CMFCToolBar::GetShowTooltips

ツール バー ボタンのツール ヒントを表示するかどうかを指定します。

static BOOL GetShowTooltips();

戻り値

TRUE ツール バー ボタンのツール ヒントが表示される場合。それ以外の場合 FALSEは .

解説

既定では、ツール ヒントが表示されます。 この静的フラグを変更するには、次を呼び出します CMFCToolBar::SetShowTooltips。

CMFCToolBar::GetSiblingToolBar

ツール バーの兄弟を取得します。

CMFCToolBar* GetSiblingToolBar();

戻り値

兄弟ツール バーへのポインター。

解説

[1 行のボタンの表示] ボタンと [2 つの行] ボタンの [ボタンの表示] を有効にする方法の詳細については、「」を参照してくださいCMFCToolBar::SetSiblingToolBar。

CMFCToolBar::GetUserImages

アプリケーション内のユーザー定義ツール バー ボタン イメージのコレクションへのポインターを返します。

static CMFCToolBarImages* GetUserImages();

戻り値

アプリケーション内のすべてのツール バーのユーザー定義ツール バー ボタン イメージのコレクションへのポインター。

解説

メソッドを CMFCToolBar::SetUserImages 呼び出して、アプリケーション内のユーザー定義イメージのコレクションを設定します。

CMFCToolBar::HitTest

指定した位置にあるツール バー ボタンのインデックスを返します。

virtual int HitTest(CPoint point);

パラメーター

point
[in]クライアント座標でテストするポイント。

戻り値

指定した位置にあるボタンのインデックス。そのようなボタンがない場合、またはボタンが区切り記号である場合は -1。

CMFCToolBar::InsertButton

ツール バーにボタンを挿入します。

virtual int InsertButton(
    const CMFCToolBarButton& button,
    INT_PTR iInsertAt=-1);

virtual int InsertButton(
    CMFCToolBarButton* pButton,
    int iInsertAt=-1);

パラメーター

button
[in]挿入するボタンを指定します。

iInsertAt
[in]ボタンを挿入する位置を 0 から始める位置を指定します。

戻り値

ボタンが挿入された位置。エラーが発生した場合は -1。

解説

-1 の場合 iInsertAt 、このメソッドはツール バー ボタンの一覧の末尾にボタンを追加します。

ツール バーに CMFCToolBar::InsertSeparator 区切り記号を挿入するメソッドを呼び出します。

CMFCToolBar::InsertSeparator

ツールバーに区切り記号を挿入します。

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

パラメーター

iInsertAt
[in]区切り記号を挿入する位置を 0 から始める位置を指定します。 このパラメーターは 0 より大きくする必要があります。

戻り値

区切り記号が挿入された位置。エラーが発生した場合は -1。

解説

このメソッドを呼び出して、既存の 2 つのボタンの間に区切り記号を挿入します。 -1 の場合 iInsertAt 、このメソッドはツールバー ボタンの一覧の末尾に区切り記号を追加します。

このメソッドを使用して、空白のツール バーに区切り記号を追加することはできません。

ツール バーに CMFCToolBar::InsertButton ボタンを挿入するメソッドを呼び出します。

CMFCToolBar::InvalidateButton

指定されたインデックスに存在するツール バー ボタンのクライアント領域を無効にします。

CMFCToolBarButton* InvalidateButton(int nIndex);

パラメーター

nIndex
[in]ツール バーのボタンの 0 から始まるインデックス。

戻り値

指定された CMFCToolBarButton インデックスに存在するオブジェクト、または NULL そのようなオブジェクトが存在しない場合のオブジェクトへのポインター。

解説

フレームワークは、ツール バー ボタンに関連付けられているクライアント領域を更新するときに、このメソッドを呼び出します。 指定されたインデックスに CWnd::InvalidateRect 存在するオブジェクトのクライアント四角形を CMFCToolBarButton 使用してメソッドを呼び出します。

CMFCToolBar::IsAddRemoveQuickCustomize

ユーザーが [カスタマイズ] メニュー オプションを使用してツール バー ボタンを追加または削除できるかどうかを決定します。

BOOL IsAddRemoveQuickCustomize();

戻り値

TRUEユーザーが [カスタマイズ] メニュー オプションを使用してツール バーを変更できる場合は 〗。FALSEそれ以外の場合は .。

解説

CMFCToolBar::IsAltCustomizeMode

ボタンのドラッグにクイック カスタマイズを使用するかどうかを指定します。 クイック カスタマイズが有効になっている場合、ユーザーは Alt キーを押しながらボタンを新しい場所にドラッグできます。

static BOOL __stdcall IsAltCustomizeMode();

戻り値

TRUEクイックカスタマイズを使用してボタンをドラッグする場合。それ以外の場合は . FALSE

解説

CMFCToolBar::IsAutoGrayInactiveImages

非アクティブ (強調表示されていない) ボタン イメージの自動生成を有効にするかどうかを指定します。

static BOOL IsAutoGrayInactiveImages();

戻り値

TRUE 非アクティブな画像を自動的に暗くするオプションが有効になっている場合。それ以外の場合 FALSEは .

解説

を呼び出 CMFCToolBar::AutoGrayInactiveImagesすことによって、非アクティブなイメージの自動調光を有効または無効にすることができます。

CMFCToolBar::IsBasicCommand

コマンドが基本コマンドの一覧にあるかどうかを判断します。

static BOOL IsBasicCommand(UINT uiCmd);

パラメーター

uiCmd
[in]チェックするコマンドを指定します。

戻り値

TRUE 指定されたコマンドが基本コマンドのリストに属している場合。それ以外の場合 FALSEは .

解説

この静的メソッドは、指定された uiCmd コマンドが基本コマンドのグローバル リストに属しているかどうかを判断します。 基本コマンドの一覧は、呼び出 CMFCToolBar::AddBasicCommand しまたは CMFCToolBar::SetBasicCommands.

CMFCToolBar::IsButtonExtraSizeAvailable

罫線が拡張されたボタンをツール バーに表示できるかどうかを指定します。

virtual BOOL IsButtonExtraSizeAvailable() const;

戻り値

TRUE バーが余分な境界線サイズのボタンを表示できる場合。それ以外の場合 FALSEは .

解説

ツール バー オブジェクトは、 TRUE 罫線が拡張されたボタンを表示できる場合に戻ります。 ツール バー ボタンは、通知を処理するときにこのメソッドを CMFCToolBarButton::OnChangeParentWnd 呼び出し、それに応じて内部の余分な境界線サイズ フラグを設定します。 この内部フラグは、後で呼び出 CMFCToolBarButton::IsExtraSizeすことによって取得できます。

派生クラスCMFCToolBarでこのメソッドをオーバーライドし、バーに余分な罫線サイズのツール バー ボタンを表示でき、それ以外の場合は戻る場合に返TRUEFALSEします。 既定の実装では、TRUE が返されます。

CMFCToolBar::IsButtonHighlighted

指定したボタンが強調表示されているかどうかを判断します。

BOOL IsButtonHighlighted(int iButton) const;

パラメーター

iButton
[in]ツール バー ボタンのインデックスを指定します。

戻り値

TRUE指定したボタンが強調表示されている場合。それ以外の場合は . FALSE

解説

CMFCToolBar::IsCommandPermitted

コマンドが許可されているかどうかを判断します。

static BOOL IsCommandPermitted(UINT uiCmd);

パラメーター

uiCmd
[in]チェックするコマンドを指定します。

戻り値

TRUE 指定したコマンドが許可されている場合は〘。それ以外の場合 FALSEは .

解説

この静的メソッドは、指定された uiCmd コマンドが許可されていないコマンドのグローバル リストに属しているかどうかを判断します。

許可されていないコマンドの一覧を変更するには、次を呼び出 CMFCToolBar::SetNonPermittedCommandsします。

CMFCToolBar::IsCommandRarelyUsed

コマンドがほとんど使用されないかどうかを判断します。

static BOOL IsCommandRarelyUsed(UINT uiCmd);

パラメーター

uiCmd
[in]チェックするコマンドを指定します。

戻り値

TRUE 指定されたコマンドがほとんど使用されない場合。それ以外の場合 FALSEは .

解説

このメソッドは IsCommandRarelyUsed 、次の FALSE 1 つ以上の条件が発生すると返されます。

  • 指定されたコマンドは、基本コマンドのリストに属しています

  • 指定されたコマンドは、標準コマンドの 1 つです

  • フレームワークはカスタマイズ モードです

  • 基本的なコマンドの一覧が空です

  • コマンド呼び出しの 20% を超えるコマンド呼び出しは、指定されたコマンドの呼び出しです。

CMFCToolBar::IsCustomizeMode

ツール バー フレームワークがカスタマイズ モードかどうかを指定します。

static BOOL IsCustomizeMode();

戻り値

TRUE フレームワークがカスタマイズ モードの場合。それ以外の場合 FALSEは .

解説

を呼び出 CMFCToolBar::SetCustomizeModeすことで、カスタマイズ モードを切り替えることができます。

フレームワークは、ユーザーがカスタマイズ ダイアログ ボックス ( CMFCToolBarsCustomizeDialog クラス) を呼び出すときにモードを変更します。

CMFCToolBar::IsDragButton

ツール バー ボタンをドラッグするかどうかを指定します。

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

パラメーター

pButton
[in]ツール バー ボタンへのポインター。

戻り値

TRUE指定したボタンがドラッグされている場合。それ以外の場合は . FALSE

解説

CMFCToolBar::IsExistCustomizeButton

ツール バーに [カスタマイズ] ボタンが含まれているかどうかを指定します。

BOOL IsExistCustomizeButton();

戻り値

TRUEツールバーに [カスタマイズ] ボタンが含まれている場合は 〗。それ以外の場合FALSEは 〗。

解説

このメソッドが返されたTRUE場合、CMFCToolBar::GetCustomizeButtonツール バーの末尾に表示される [カスタマイズ] ボタンへのポインターが返されます。

ツール バーに CMFCToolBar::EnableCustomizeButton [カスタマイズ] ボタンを追加するには、このメソッドを使用します。

CMFCToolBar::IsFloating

ツール バーが浮動かどうかを判断します。

virtual BOOL IsFloating() const;

戻り値

TRUEツール バーが浮動の場合は 〗。それ以外の場合は . FALSE

CMFCToolBar::IsLargeIcons

アプリケーションのツール バーに現在大きなアイコンを表示するかどうかを指定します。

static BOOL IsLargeIcons();

戻り値

TRUE アプリケーションが大きなアイコンを使用している場合。それ以外の場合 FALSEは .

解説

大きいアイコンと通常のアイコンを切り替える呼び出 CMFCToolBar::SetLargeIcons し。

フレームワークは、ユーザーが [カスタマイズ] ダイアログ ボックスの [オプション] ページの [大きいアイコン] チェックボックスを切り替えると、モードを自動的に変更します。

CMFCToolBar::IsLastCommandFromButton

指定したツール バー ボタンから、最後に実行されたコマンドが送信されたかどうかを判断します。

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

パラメーター

pButton
[in]ボタンへのポインター。

戻り値

TRUE 指定したボタン pButton から最後のコマンドが送信された場合は 〗。それ以外の場合 FALSEは 。

解説

このメソッドは、呼び出CWnd::GetCurrentMessageすことによって構造体へのポインターをMSG取得します。 次に、ボタンとHWNDメンバーMSG::hwndを比較して、MSG::lParamボタンがコマンドのソースであるかどうかを判断します。

CMFCToolBar::IsLocked

ツール バーがロックされているかどうかを判断します。

BOOL IsLocked() const;

戻り値

TRUEツールバーがロックされている場合。それ以外の場合は . FALSE

解説

このメソッドは、 TRUE ユーザーがツール バー ボタンの位置を変更するなどのカスタマイズ タスクを実行できない場合に返します。

ロックされたツールバーでは、個別のイメージ リストが使用されます。 これらのイメージ リストの詳細については、次を参照してください CMFCToolBar::LoadBitmapEx。

CMFCToolBar::IsOneRowWithSibling

ツール バーとその兄弟ツール バーが同じ行に配置されているかどうかを判断します。

BOOL IsOneRowWithSibling();

戻り値

TRUE ツールバーとその兄弟が同じ行に配置されている場合。それ以外の場合 FALSEは .

解説

このメソッドはCMFCCustomizeButton::CreatePopupMenu、このメソッドを呼び出して、[カスタマイズ] ポップアップ メニューの表示方法を決定します。 このメソッドが返されたTRUE場合、フレームワークは[1 行にボタンを表示]ボタンを表示します。 それ以外の場合、フレームワークは [2 つの行にボタンを表示] ボタンを表示します。

通常、このメソッドを使用する必要はありません。 [1 行のボタンの表示] または [2 つの行] ボタンの [ボタンの表示] を有効にするには、 を呼び出しますCMFCToolBar::SetSiblingToolBar。

CMFCToolBar::IsResourceChanged

virtual BOOL IsResourceChanged() const;

戻り値

解説

CMFCToolBar::IsSibling

BOOL IsSibling();

戻り値

解説

CMFCToolBar::IsUserDefined

ツール バーがユーザー定義かどうかを指定します。

BOOL IsUserDefined() const;

戻り値

TRUE ツールバーがユーザーによって作成された場合。それ以外の場合 FALSEは .

CMFCToolBar::LoadBitmap

アプリケーション リソースからツール バー イメージを読み込みます。

virtual BOOL LoadBitmap(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

パラメーター

uiResID
[in]ホット ツール バーイメージを参照するビットマップのリソース ID。

uiColdResID
[in]コールド ツール バー イメージを参照するビットマップのリソース ID。

uiMenuResID
[in]通常のメニュー イメージを参照するビットマップのリソース ID。

bLocked
[in] TRUE ツールバーをロックするには、それ以外の場合 FALSEは .

uiDisabledResID
[in]無効になっているツール バー イメージを参照するビットマップのリソース ID。

uiMenuDisabledResID
[in]無効なメニュー イメージを参照するビットマップのリソース ID。

戻り値

メソッドが成功した場合は 0 以外。それ以外の場合は 0。

解説

このメソッドは CMFCToolBar::LoadToolBarEx 、ツール バーに関連付けられているイメージを読み込むには、このメソッドを呼び出します。 このメソッドをオーバーライドして、イメージ リソースのカスタムの読み込みを実行します。

ツール バーの作成後に、 LoadBitmapEx メソッドを呼び出して追加のイメージを読み込みます。

CMFCToolBar::LoadBitmapEx

virtual BOOL LoadBitmapEx(
    CMFCToolBarInfo& params,
    BOOL bLocked = FALSE);

パラメーター

[入力] params
[入力] bLocked\

戻り値

解説

CMFCToolBar::LoadLargeIconsState

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

パラメーター

[入力] lpszProfileName\

戻り値

解説

CMFCToolBar::LoadParameters

Windows レジストリからグローバル ツール バー オプションを読み込みます。

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

パラメーター

lpszProfileName
[in]Windows レジストリ キーの相対パスを指定します。

戻り値

メソッドが成功した場合は 0 以外。それ以外の場合は 0。

解説

このメソッドは、メニュー アニメーションの種類、メニュー シャドウ スタイル、Windows レジストリから大きなアイコンを表示するかどうかなどのグローバル パラメーターを読み込みます。

このメソッドは CWinAppEx::LoadState 、アプリケーションの初期化プロセスの一部としてこのメソッドを呼び出します。

CMFCToolBar::LoadState

Windows レジストリからツール バーの状態情報を読み込みます。

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

パラメーター

lpszProfileName
[in]Windows レジストリ キーの相対パスを指定します。

nIndex
[in]ツール バーのコントロール ID を指定します。

uiID
[in]ツール バーのリソース ID を指定します。

戻り値

メソッドが成功した場合は 0 以外。それ以外の場合は 0。

解説

フレームワークは、アプリケーションの初期化プロセスの一部としてこのメソッドを呼び出します。 詳細については、CWinAppEx::LoadStateを参照してください。

CMFCToolBar::LoadToolBar

アプリケーション リソースからツール バーを読み込みます。

virtual BOOL LoadToolBar(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0,
    UINT uiHotResID=0);

パラメーター

uiResID
[in]ツール バーのリソース ID。

uiColdResID
[in]コールド ツール バー イメージを参照するビットマップのリソース ID。

uiMenuResID
[in]通常のメニュー イメージを参照するビットマップのリソース ID。

bLocked
[in]ツール バーがロックされているかどうかを示すブール値。 このパラメーターが指定されている TRUE場合、ツール バーはロックされます。 それ以外の場合、ツール バーはロックされません。

uiDisabledResID
[in]無効になっているツール バー イメージを参照するビットマップのリソース ID。

uiMenuDisabledResID
[in]無効なメニュー イメージを参照するビットマップのリソース ID。

uiHotResID
[in]ホット ツール バーイメージを参照するビットマップのリソース ID。

戻り値

メソッドが成功した場合は 0 以外。それ以外の場合は 0。

解説

フレームワークは、初期化中にこのメソッドを呼び出して、ツール バーに関連付けられているイメージを読み込みます。

例

次の例では、クラスでメソッドを使用する LoadToolBar 方法を CMFCToolBar 示します。 このコード スニペットは、IE デモ サンプルの一部です。

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

CMFCToolBar::LoadToolBarEx

ヘルパー クラスを使用してアプリケーション リソースからツール バーを CMFCToolBarInfo 読み込み、アプリケーションで大きなイメージを使用できるようにします。

virtual BOOL LoadToolBarEx(
    UINT uiToolbarResID,
    CMFCToolBarInfo& params,
    BOOL bLocked=FALSE);

パラメーター

uiToolbarResID
[in]ツール バーのリソース ID。

params
[in]ツール バー イメージの CMFCToolBarInfo リソース ID を含むオブジェクトへの参照。

bLocked
[in]ツール バーがロックされているかどうかを示すブール値。 このパラメーターが指定されている TRUE場合、ツール バーはロックされます。 それ以外の場合、ツール バーはロックされません。

戻り値

メソッドが成功した場合は 0 以外。それ以外の場合は 0。

解説

このメソッドを呼び出して、アプリケーション リソースからツール バー イメージを読み込みます。

CMFCToolBar::m_dblLargeImageRatio

大きな画像の寸法(高さまたは幅)と通常の画像の寸法との比率を指定します。

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

解説

既定の比率は 2 です。 この値を変更して、大きなツール バーイメージを大きくしたり小さくしたりできます。

大きなイメージのセットを指定しない場合、フレームワークはこのデータ メンバーを使用します。 たとえば、サイズが 16 x 16 の小さなイメージのセットのみを指定し、大きなイメージのサイズを 24 x 24 にする場合は、このデータ メンバーを 1.5 に設定します。

CMFCToolBar::NextMenu

virtual BOOL NextMenu();

戻り値

解説

CMFCToolBar::OnBeforeRemoveButton

virtual BOOL OnBeforeRemoveButton(
    CMFCToolBarButton* pButton,
    DROPEFFECT dropEffect);

パラメーター

pButton
[in] 使用されていません。

dropEffect
[入力] 使用されていません。

戻り値

解説

CMFCToolBar::OnChangeHot

ユーザーがツール バーのボタンを選択すると、フレームワークによって呼び出されます。

virtual void OnChangeHot(int iHot);

パラメーター

iHot
[in]選択されているツール バー ボタンのインデックスを指定します。ツール バー ボタンが選択されていない場合は -1。

解説

ユーザーがツール バーのボタンを選択したことを示す通知を処理するには、このメソッドをオーバーライドします。

CMFCToolBar::OnChangeVisualManager

virtual void OnChangeVisualManager();

解説

CMFCToolBar::OnFillBackground

ツール バーの背景を塗りつぶすためにフレームワーク CBasePane::DoPaint によって呼び出されます。

virtual void OnFillBackground(CDC* pDC);

パラメーター

pDC
[入力] デバイス コンテキストへのポインター。

解説

CMFCToolBar::DoPaint は、ツールバーの背景が塗りつぶされたときにこのメソッドを呼び出します。 既定の実装では、何も行われません。

派生クラスでカスタム背景を描画するには、このメソッドをオーバーライドします。

CMFCToolBar::OnGlobalFontsChanged

virtual void OnGlobalFontsChanged();

解説

CMFCToolBar::OnReset

ツールバーを元の状態に戻します。

virtual void OnReset();

解説

ツール バーのリセットに関する通知を処理するには、このメソッドをオーバーライドします。

既定の実装では、何も行われません。 ツール バーが元の状態に戻ったときに置き換える必要があるダミー ボタンがある場合に派生CMFCToolBarしたクラスでオーバーライドOnResetします。

CMFCToolBar::OnSetAccData

virtual BOOL OnSetAccData(long lVal);

パラメーター

[入力] lVal\

戻り値

解説

CMFCToolBar::OnSetDefaultButtonText

ツール バー ボタンのテキストを既定の状態に戻します。

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

パラメーター

pButton
[in]テキストが設定されているボタンをポイントします。

戻り値

TRUE テキストが正常に復元された場合。それ以外の場合 FALSEは .

解説

ツール バー ボタンのテキストが既定に変更されていることを示す通知を処理するには、このメソッドをオーバーライドします。

既定の実装では、アプリケーション リソースからボタンのテキストが読み込まれます。

CMFCToolBar::OnUserToolTip

ボタンのツールヒントが表示されようとしているときにフレームワークによって呼び出されます。

virtual BOOL OnUserToolTip(
    CMFCToolBarButton* pButton,
    CString& strTTText) const;

パラメーター

pButton
[in]ツール ヒントを表示するツール バー ボタンをポイントします。

strTTText
[out]ヒントの CString テキストを受け取るオブジェクトへの参照。

戻り値

TRUEヒント テキストが設定されている場合は、それ以外の場合strTTTextFALSEは >

解説

フレームワークは、ツール バー ボタンのツール ヒントが表示されるときに、このメソッドを呼び出します。 返された場合、フレームワークによって返されるテキストを含むツールヒントが表示されますstrTTTextOnUserToolTip。OnUserToolTipTRUE それ以外の場合は、ツールヒントにボタンテキストが含まれます。

ツール バー ボタンのツール ヒントをカスタマイズするには、オーバーライド OnUserToolTip します。 既定の実装では、ツールヒント テキストを取得する呼び出し CMFCToolBar::OnUserToolTip です。

CMFCToolBar::PrevMenu

virtual BOOL PrevMenu();

戻り値

解説

CMFCToolBar::ProcessCommand

ツール バーを WM_COMMAND 所有するウィンドウにメッセージを投稿します。

BOOL ProcessCommand(CMFCToolBarButton* pButton);

パラメーター

pButton
[in]ツール バーのボタンへのポインター。

戻り値

このメソッドは常に TRUE を返す必要があります。 MFC は内部的に値を使用 FALSE します。

解説

このメソッドは、 WM_COMMAND 指定したボタンのコマンド ID をパラメーターとして呼び出 CWnd::PostMessage して渡すことによって、ツール バーを所有するウィンドウにメッセージを wParam 投稿します。

マクロを ON_COMMAND 使用して、メッセージを WM_COMMAND メンバー関数にマップします。

CMFCToolBar::RemoveAllButtons

ツールバーからすべてのボタンと区切り記号を削除します。

virtual void RemoveAllButtons();

解説

フレームワークは、ツール バーを再作成または破棄するときに、このメソッドを呼び出します。

CMFCToolBar::RemoveButton

指定したインデックスを持つボタンをツール バーから削除します。

virtual BOOL RemoveButton(int iIndex);

パラメーター

iIndex
[in]削除するボタンの 0 から始まるインデックスを指定します。

戻り値

TRUEメソッドが成功した場合、またはFALSE指定したインデックスが無効であるか、インデックスが [カスタマイズ] ボタンを参照している場合。

解説

このメソッドは、ボタンの削除の影響を受ける追加のツール バー属性を更新します。 たとえば、このメソッドはツールバーから不要な区切り記号を削除し、ショートカット キーのテーブルを再構築します。

[カスタマイズ] ボタンの詳細については、次を参照してくださいCMFCToolBar::EnableCustomizeButton。

CMFCToolBar::RemoveStateFromRegistry

ツール バーの状態情報を Windows レジストリから削除します。

virtual BOOL RemoveStateFromRegistry(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

パラメーター

lpszProfileName
[in]状態情報が格納されているレジストリ キーを指定します。

nIndex
[in]ツール バーのコントロール ID。

uiID
[in]ツール バーのリソース ID。 このパラメーターが -1 の場合、このメソッドはメソッドを CWnd::GetDlgCtrlID 使用してリソース ID を取得します。

戻り値

メソッドが成功した場合は 0 以外。それ以外の場合は 0。

解説

フレームワークは、ユーザー定義ツール バーを削除するときにこのメソッドを呼び出します。

Windows レジストリに追加の状態情報を格納する場合は、このメソッドをオーバーライドします。

CMFCToolBar::ReplaceButton

ツール バー ボタンを別のツール バー ボタンに置き換えます。

int ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button,
    BOOL bAll=FALSE);

パラメーター

uiCmd
[in]置き換えるボタンのコマンド ID。

button
[in]挿入する参照 CMFCToolBarButton 。

bAll
[in]で指定されたコマンド ID を持つすべてのボタンを置き換えるかどうかを指定 uiCmdするブール値。 このパラメーターの場合、 TRUE指定したコマンド ID を持つすべてのボタンが置き換えられます。 それ以外の場合は、最初のボタンが置き換えられます。

戻り値

置き換えられるボタンの数。 指定したコマンド ID のボタンがツール バーに存在しない場合、このメソッドは 0 を返します。

解説

リソースから読み込むことができないツール バー ボタンを追加する場合は、このメソッドを呼び出します。 デザイン時にプレースホルダー ボタンを作成し、ツール バーを初期化するときにそのボタンをカスタム ボタンに置き換えることができます。 このメソッドを使用する例については、VisualStudioDemo サンプルを参照してください。

例

次の例では、クラスでメソッドを使用する ReplaceButton 方法を CMFCToolBar 示します。 このコード スニペットは、IE デモ サンプルの一部です。

CMFCToolBar m_wndToolBar;

// CMenu menuHistory
// CString str
m_wndToolBar.ReplaceButton(ID_GO_BACK,
                           CMFCToolBarMenuButton(ID_GO_BACK, menuHistory,
                                                 GetCmdMgr()->GetCmdImage(ID_GO_BACK), str));

CMFCToolBar::ResetAll

すべてのツールバーを元の状態に戻します。

static void __stdcall ResetAll();

解説

このメソッドは、復元可能なアプリケーションの各ツール バーでメソッドを呼び出 CMFCToolBar::RestoreOriginalState します。 このメソッドを CMFCToolBar::CanBeRestored 使用して、ツール バーを復元できるかどうかを判断します。

CMFCToolBar::ResetAllImages

アプリケーション内のすべてのツール バー イメージ コレクションをクリアします。

static void __stdcall ResetAllImages();

解説

このメソッドは、メソッドCMFCToolBar::LoadBitmapによって初期化されたイメージ コレクションをCMFCToolBar::LoadToolBarクリアします。

CMFCToolBar::ResetImages

virtual void ResetImages();

解説

CMFCToolBar::RestoreFocus

virtual void RestoreFocus();

解説

CMFCToolBar::RestoreOriginalState

ツール バーを元の状態に戻します。

virtual BOOL RestoreOriginalState();

戻り値

TRUE メソッドが成功した場合、または FALSE メソッドが失敗した場合、またはツール バーがユーザー定義の場合。

解説

このメソッドは、メソッドを使用してリソース ファイルからツール バーを CMFCToolBar::LoadToolBar 読み込みます。

フレームワークは、ユーザーがカスタマイズ ダイアログ ボックスの [ツール バー] ページで [すべて リセット] ボタンを 選択すると、このメソッドを呼び出 します。

CMFCToolBar::SaveParameters

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

パラメーター

[入力] lpszProfileName\

戻り値

解説

CMFCToolBar::SaveState

Windows レジストリのツール バーの状態情報を保存します。

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

パラメーター

lpszProfileName
[in]Windows レジストリ キーの相対パスを指定します。

nIndex
[in]ツール バーのコントロール ID。

uiID
[in]ツール バーのリソース ID。

戻り値

メソッドが成功した場合は 0 以外。それ以外の場合は 0。

解説

フレームワークは、アプリケーションの状態をレジストリに保存するときに、このメソッドを呼び出します。 詳細については、CWinAppEx::SaveStateを参照してください。

CMFCToolBar::SetBasicCommands

ユーザーがメニューを開いたときに常に表示されるコマンドの一覧を設定します。

static void __stdcall SetBasicCommands(CList<UINT,UINT>& lstCommands);

パラメーター

lstCommands
[in]コマンドのコレクションを CList 含むオブジェクトへの参照。

解説

メニューを開くと、基本コマンドが常に表示されます。 このメソッドは、ユーザーが最近使用したコマンドを表示することを選択した場合に意味があります。

このメソッドを CMFCToolBar::AddBasicCommand 使用して、基本的なコマンドの一覧にコマンドを追加します。 このメソッドを CMFCToolBar::GetBasicCommands 使用して、アプリケーションで使用される基本的なコマンドの一覧を取得します。

このメソッドを使用する例については、エクスプローラーサンプルを参照してください。

CMFCToolBar::SetButtonInfo

ツール バー ボタンのコマンド ID、スタイル、イメージ ID を設定します。

void SetButtonInfo(
    int nIndex,
    UINT nID,
    UINT nStyle,
    int iImage);

パラメーター

nIndex
[in]プロパティが設定されているボタンの 0 から始まるインデックス。

nID
[in]ボタンのコマンド ID。

nStyle
[in]ボタンのスタイル。 使用可能なツール バー ボタン スタイルの一覧については、「ToolBar コントロール のスタイル」を参照してください。

iImage
[in]ボタンの 0 から始まるイメージ インデックス (つまり、ツール バー イメージのコレクション内のインデックス)。

解説

ツール バー ボタンのプロパティを設定するには、このメソッドを呼び出します。

デバッグ ビルドでは、指定された nIndex インデックスが無効な場合、このメソッドはアサーション エラーを生成します。

ボタンの CMFCToolBar::SetButtonStyle スタイルのみを設定するメソッドを呼び出します。

CMFCToolBar::SetButtons

ツール バーのボタンを設定します。

virtual BOOL SetButtons(
    const UINT* lpIDArray,
    int nIDCount,
    BOOL bRemapImages=TRUE);

パラメーター

lpIDArray
[in]挿入するボタンのコマンド ID の配列へのポインター。

nIDCount
[in] lpIDArray 内の項目の数。

bRemapImages
[in]既存のボタン イメージを挿入されたボタンに関連付けるかどうかを指定するブール値。 このパラメーターが指定されている TRUE場合、イメージは再マップされます。

戻り値

メソッドが成功した場合は 0 以外。それ以外の場合は 0。

解説

ツール バーから既存のボタンを削除し、新しいボタンのコレクションを挿入するには、このメソッドを呼び出します。

このメソッドは、ツール バーに [カスタマイズ] ボタンを追加し、ツールバーのAFX_WM_RESETTOOLBAR親ウィンドウにメッセージを送信します。 [カスタマイズ] ボタンの詳細については、次を参照してくださいCMFCToolBar::EnableCustomizeButton。

CMFCToolBar::SetButtonStyle

指定したインデックス位置にあるツール バー ボタンのスタイルを設定します。

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

パラメーター

nIndex
[in]スタイルを設定するツール バー ボタンの 0 から始まるインデックス。

nStyle
[in]ボタンのスタイル。 使用可能なツール バー ボタン スタイルの一覧については、「ToolBar コントロール のスタイル」を参照してください。

解説

ユーザーが無効なボタンをTBBS_PRESSED選択できないため、このメソッドはTBBS_DISABLEDスタイルnStyleを削除します。

CMFCToolBar::SetButtonText

ツール バー ボタンのテキスト ラベルを設定します。

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

パラメーター

nIndex
[in]ツール バー ボタンのインデックス。

lpszText
[in]ツール バー ボタンのテキスト ラベル。 null 以外である必要があります。

戻り値

TRUE メソッドが成功した場合。それ以外の場合 FALSEは .

解説

このメソッドは、 FALSE 指定されたインデックスが有効なツール バー ボタンを参照していない場合に返します。

CMFCToolBar::SetCommandUsageOptions

使用頻度の低いコマンドがアプリケーションのメニューに表示されない場合に指定します。

static BOOL SetCommandUsageOptions(
    UINT nStartCount,
    UINT nMinUsagePercentage=5);

パラメーター

nStartCount
[in]フレームワークが基本コマンドと最近使用したコマンドのみを表示するまでにコマンドを実行する必要がある回数を指定します。

nMinUsagePercentage
[in]最近使用したコマンドと見なされるためにコマンドを実行する必要がある時間の割合。

戻り値

FALSE100 以上の場合は、それ以外の場合nMinUsagePercentageTRUEは >

解説

このメソッドを呼び出して、基本的なメニュー項目と最近使用したメニュー項目の表示方法を決定するためにフレームワークが使用するアルゴリズムをカスタマイズします。 基本的なコマンドの詳細については、次を参照してください CMFCToolBar::AddBasicCommand。

このクラスでは、このクラスを CMFCCmdUsageCount 使用してコマンドの使用数を追跡します。 このクラスの詳細については、「クラス」を参照してください。CMFCCmdUsageCount

CMFCToolBar::SetCustomizeMode

アプリケーション内のすべてのツール バーのカスタマイズ モードを有効または無効にします。

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

パラメーター

bSet
[in]カスタマイズ モードを有効または無効にするかどうかを指定するブール値。 カスタマイズ モードを TRUE 有効にするか、無効 FALSE にするには、このパラメーターを設定します。

戻り値

TRUE このメソッドを呼び出すと、カスタマイズ モードが変更されます。それ以外の場合 FALSEは .

解説

このメソッドは、アプリケーションの各ツール バーのレイアウトを調整し、再描画します。 メソッドを CMFCToolBar::IsCustomizeMode 呼び出して、アプリケーションがカスタマイズ モードであるかどうかを判断します。

CMFCToolBar::SetGrayDisabledButtons

ツール バーの使用できないボタンを淡色表示にするか、ボタンを使用できないイメージを使用するかを指定します。

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

パラメーター

bGrayDisabledButtons
[in]使用できないボタンを表示する方法を指定するブール値。 このパラメーターの場合、 TRUEフレームワークはボタンを暗くします。 それ以外の場合、フレームワークはボタンを使用できないイメージのコレクションを使用します。

解説

既定では、使用できないボタンは淡色表示になっています。

CMFCToolBar::SetHeight

ツールバーの高さを設定します。

void SetHeight(int cyHeight);

パラメーター

cyHeight
[in]ツールバーの高さ (ピクセル単位)。

解説

このメソッドは、高さを設定した後、ツール バーを再描画します。

CMFCToolBar::SetHelpMode

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

パラメーター

[入力] bOn\

解説

CMFCToolBar::SetHot

BOOL SetHot(CMFCToolBarButton* pMenuButton);

パラメーター

[入力] pMenuButton\

戻り値

解説

CMFCToolBar::SetHotBorder

ツール バー ボタンをホット トラックするかどうかを指定します。

void SetHotBorder(BOOL bShowHotBorder);

パラメーター

bShowHotBorder
[in]ツール バー ボタンをホット トラックするかどうかを指定するブール値。 このパラメーターの場合、 TRUEツール バーはボタンをホット トラックします。 それ以外の場合、ツール バーはボタンをホット トラックしません。

解説

ボタンがホット トラックされている場合、マウスがボタンの間を移動すると、フレームワークによってボタンが強調表示されます。 既定では、各ツール バーはボタンをホットトラックします。

このメソッドを CMFCToolBar::GetHotBorder 呼び出して、ツール バーがボタンをホットトラックするかどうかを判断します。

CMFCToolBar::SetHotTextColor

ホット ツールバー ボタンのテキストの色を設定します。

static void SetHotTextColor(COLORREF clrText);

パラメーター

clrText
[in]ホット トラックされるツール バー ボタンのテキストの色を指定します。

解説

ホット トラックツール バー ボタンの詳細については、「〘」をCMFCToolBar::SetHotBorder参照してくださいCMFCToolBar::GetHotBorder。

CMFCToolBar::SetIgnoreSetText

void SetIgnoreSetText(BOOL bValue);

パラメーター

[入力] bValue\

解説

CMFCToolBar::SetLargeIcons

ツール バー ボタンに大きなアイコンを表示するかどうかを指定します。

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

パラメーター

bLargeIcons
[in]使用するアイコンを指定するブール値。 このパラメーターの場合、 TRUEフレームワークには大きなアイコンが表示されます。 それ以外の場合、フレームワークには通常のアイコンが表示されます。

解説

フレームワークは、ユーザーが [カスタマイズ] ダイアログ ボックスの [オプション] タブの [大きいアイコン] チェック ボックスの状態を変更するときに、このメソッドを呼び出します。 このメソッドは、アプリケーション内のすべてのツール バーのサイズを変更します。

既定では、フレームワークには通常のアイコンが表示されます。

[カスタマイズ] ダイアログ ボックスの詳細については、「クラス」を参照してくださいCMFCToolBarsCustomizeDialog。

CMFCToolBar::SetLockedSizes

ツール バーのロックされたボタンとロックされたイメージのサイズを設定します。

void SetLockedSizes(
    SIZE sizeButton,
    SIZE sizeImage,
    BOOL bDontScale = FALSE);

パラメーター

sizeButton
[in]ロックされているツール バー ボタンのサイズを指定します。

sizeImage
[in]ロックされたツール バー イメージのサイズを指定します。

bDontScale
ツール バー イメージを高 DPI モードで拡大または縮小するかどうかを指定します。

解説

ロックされたボタンの既定のサイズは 23 x 22 ピクセルです。 ロックされたイメージの既定のサイズは 16 x 15 ピクセルです。

ロックされたイメージの CMFCToolBar::GetLockedImageSize サイズを取得するメソッドを呼び出します。 ロックされた CMFCToolBar::GetButtonSize ツール バー ボタンのサイズを取得するメソッドを呼び出します。

CMFCToolBar::SetMaskMode

void SetMaskMode(BOOL bMasked);

パラメーター

[入力] bMasked\

解説

CMFCToolBar::SetMenuSizes

ツール バー メニュー ボタンとそのイメージのサイズを設定します。

static void __stdcall SetMenuSizes(
    SIZE sizeButton,
    SIZE sizeImage);

パラメーター

sizeButton
[in]ツールバー ボタンのサイズをピクセル単位で指定します。

sizeImage
[in]ツールバーイメージのサイズをピクセル単位で指定します。

解説

既定では、メニュー ボタンとそのイメージのサイズは未定義です。

メソッドを CMFCToolBar::GetMenuButtonSize 呼び出してメニュー ボタンのサイズを確認し、メソッドを CMFCToolBar::GetMenuImageSize 呼び出してメニュー ボタンのイメージのサイズを決定します。

このメソッドを使用する例については、IEDemo と MSMoneyDemo のサンプルを参照してください。

CMFCToolBar::SetNonPermittedCommands

ユーザーが実行できないコマンドの一覧を設定します。

static void SetNonPermittedCommands(CList<UINT,UINT>& lstCommands);

パラメーター

lstCommands
[in]ユーザーが実行できないコマンドを含むオブジェクトへの CList 参照。

解説

ユーザーが特定のコマンドを選択できないようにするには、このメソッドを呼び出します。 たとえば、セキュリティ上の理由からユーザーが特定のコマンドを選択できないようにすることができます。 このメソッドを使用する例については、MDITabsDemo と MenuSubSet のサンプルを参照してください。

このメソッドは、許可されていないコマンドの前の一覧をクリアします。 既定では、許可されていないコマンドの一覧は空です。

CMFCToolBar::SetOneRowWithSibling

ツール バーとその兄弟を同じ行に配置します。

void SetOneRowWithSibling();

解説

フレームワークは、ユーザーが [1 行にボタンを表示] ボタンを選択すると、このメソッドを呼び出します。

メソッドをCMFCToolBar::SetSiblingToolBar呼び出して、[1 行のボタンの表示] または [2 行のボタンの表示] ボタンを有効にします。 このツール バーを呼び出 CMFCToolBar::SetSiblingToolBar すと、兄弟ツール バーがこのツール バーの行に移動します。 それ以外の場合、このツール バーは兄弟の行に移動されます。

フレームワークは、CMFCToolBar::SetTwoRowsWithSiblingユーザーが [2 つの行にボタンを表示] ボタンを選択したときにメソッドを呼び出します。

CMFCToolBar::SetOrigButtons

void SetOrigButtons(const CObList& lstOrigButtons);

パラメーター

[入力] lstOrigButtons\

解説

CMFCToolBar::SetPermament

ユーザーがツール バーを閉じることができるかどうかを指定します。

void SetPermament(BOOL bPermament=TRUE);

パラメーター

bPermament
[in]ユーザーがツール バーを閉じることができるかどうかを指定するブール値。 このパラメーターが指定されている場合、ユーザーは TRUEツール バーを閉じることができません。 それ以外の場合、ユーザーはツール バーを閉じます。

解説

既定では、ユーザーは各ツール バーを閉じます。

メソッドを CMFCToolBar::CanBeClosed 呼び出して、ユーザーがツール バーを閉じることができるかどうかを判断します。

CMFCToolBar::SetRouteCommandsViaFrame

親フレームまたは所有者がツール バーにコマンドを送信するかどうかを指定します。

void SetRouteCommandsViaFrame(BOOL bValue);

パラメーター

bValue
[in]このパラメーターが指定されている場合、親フレームは TRUEコマンドをツール バーに送信します。 それ以外の場合、所有者はコマンドをツール バーに送信します。

解説

既定では、親フレームはツール バーにコマンドを送信します。 メソッドを CMFCToolBar::GetRouteCommandsViaFrame 呼び出して、親フレームまたは所有者がツール バーにコマンドを送信するかどうかを判断します。

CMFCToolBar::SetShowTooltips

フレームワークにツール ヒントを表示するかどうかを指定します。

static void SetShowTooltips(BOOL bValue);

パラメーター

bValue
[in]このパラメーターが指定されている場合、 TRUEフレームワークにはツール ヒントが表示されます。 それ以外の場合、フレームワークはツール ヒントを非表示にします。

解説

既定では、フレームワークにはツール ヒントが表示されます。

メソッドを CMFCToolBar::GetShowTooltips 呼び出して、フレームワークにツール ヒントが表示されるかどうかを確認します。

CMFCToolBar::SetSiblingToolBar

ツール バーの兄弟を指定します。

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

パラメーター

pBrotherToolbar
[in]兄弟ツール バーへのポインター。

解説

このメソッドは、ユーザーが [カスタマイズ] ポップアップ メニューを表示するときに表示される [1 行 のボタンの表示] または [2 行 のボタンの表示] ボタンを 有効 にします。 関連するツール バーを同じ行に表示するか、別の行に表示するかをユーザーが指定できるようにする場合は、このメソッドを呼び出します。

ツール バーに表示される [カスタマイズ] ボタンを有効にした後、このメソッドを呼び出します。 [カスタマイズ] ボタンを有効にするには、メソッドをCMFCToolBar::EnableCustomizeButton呼び出します。

ツール バーの兄弟を取得するには、次を呼び出します CMFCToolBar::GetSiblingToolBar。

CMFCToolBar::SetSizes

すべてのツール バーのボタンと画像のサイズを指定します。

static void __stdcall SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

パラメーター

sizeButton
[in]ツールバー ボタンのサイズ (ピクセル単位)。

sizeImage
[in]ツールバー ボタンイメージのサイズ (ピクセル単位)。

解説

ツール バー ボタンの既定のサイズは 23 x 22 ピクセルです。 ツール バー ボタンの画像の既定のサイズは 16 x 15 ピクセルです。

ツール バー ボタンイメージの CMFCToolBar::GetImageSize サイズを取得するメソッドを呼び出します。 ツール バー ボタンの CMFCToolBar::GetButtonSize サイズを取得するメソッドを呼び出します。

CMFCToolBar::SetToolBarBtnText

ツール バーのボタンのプロパティを指定します。

void SetToolBarBtnText(
    UINT nBtnIndex,
    LPCTSTR szText=NULL,
    BOOL bShowText=TRUE,
    BOOL bShowImage=TRUE);

パラメーター

nBtnIndex
[in]ツール バー ボタンの一覧にあるツール バー ボタンの 0 から始まるインデックス。

szText
[in]ツール バー ボタンのテキスト ラベルを指定します。

bShowText
[in]このパラメーターが指定されている場合、 TRUEフレームワークにはテキスト ラベルが表示されます。 それ以外の場合、フレームワークはテキスト ラベルを非表示にします。

bShowImage
[in]このパラメーターが指定されている場合、 TRUEフレームワークにはツール バー ボタンの画像が表示されます。 それ以外の場合、フレームワークはツール バー ボタンのイメージを非表示にします。

解説

既定では、フレームワークにはツール バー ボタンの画像が表示されますが、ツール バー ボタンのテキスト ラベルは表示されません。

デバッグ ビルドでは、このメソッドは、有効なツール バー ボタンを参照しないか、ツール バー ボタンが区切り記号である場合 nBtnIndex にアサーション エラーを生成します。

CMFCToolBar::SetTwoRowsWithSibling

ツールバーとその兄弟を別々の行に配置します。

void SetTwoRowsWithSibling();

解説

フレームワークは、ユーザーが [2 行のボタンの表示] ボタンを選択すると、このメソッドを呼び出します。

メソッドをCMFCToolBar::SetSiblingToolBar呼び出して、[1 行のボタンの表示] または [2 行のボタンの表示] ボタンを有効にします。 このツール バーを呼び出 CMFCToolBar::SetSiblingToolBar すと、兄弟ツール バーは別の行に移動されます。 それ以外の場合、このツール バーは別の行に移動されます。

フレームワークは、ユーザーが [1 行にCMFCToolBar::SetOneRowWithSiblingボタンを表示] ボタンを選択したときにメソッドを呼び出します。

CMFCToolBar::SetUserImages

アプリケーション内のユーザー定義イメージのコレクションを設定します。

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

パラメーター

pUserImages
[in]ユーザー定義イメージのコレクションへのポインター。

戻り値

メソッドが成功した場合は 0 以外。指定した CMFCToolBarImages オブジェクトが有効でない場合、またはツール バーの既定のイメージ サイズと異なるイメージ サイズを持つ場合は 0。

解説

フレームワークでは、ユーザー定義のイメージを使用して、ユーザーがカスタマイズしたツール バー ボタンを描画します。 指定された pUserImages イメージ リストは、アプリケーション内のすべてのツール バー間で共有されます。

このメソッドは、指定した CMFCToolBarImages オブジェクトが有効でない場合、またはツール バーの既定のイメージ サイズと異なるイメージ サイズを持つ場合に、デバッグ ビルドでアサーション エラーを生成します。

OutlookDemo、ToolTipDemo、VisualStudioDemo のサンプルでは、このメソッドを使用して、ユーザー定義イメージのグローバル コレクションを設定します。 アプリケーションの作業ディレクトリにある UserImages.bmp という名前のファイルを読み込みます。

'CMFCToolBar::GetUserImages メソッドを呼び出して、アプリケーション内のユーザー定義イメージのコレクションを取得します。

CMFCToolBar::StretchPane

ツールバーを垂直方向または水平方向に引き伸ばし、必要に応じてボタンの位置を変更します。

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

パラメーター

nLength
[in]ウィンドウを拡大する量 (ピクセル単位)。

bVert
[in]の場合 TRUEは、ウィンドウを垂直方向に引き伸ばします。 の場合 FALSEは、ウィンドウを水平方向に引き伸ばします。

戻り値

CSizeツール バー クライアント領域のサイズを指定するオブジェクト。

解説

このメソッドは、ストレッチ ツールバー内のボタンの位置を変更するために呼び出 CMFCToolBar::WrapToolBar します。

戻り値は呼び出 CMFCToolBar::CalcSizeしによって決定されます。

CMFCToolBar::TranslateChar

指定したキー コードが有効なキーボード ショートカットに対応する場合は、ボタン コマンドを実行します。

virtual BOOL TranslateChar(UINT nChar);

パラメーター

nChar
[in]仮想キー コードを指定します。 標準の仮想キー コードの一覧については、 Winuser.h

戻り値

FALSE 指定されたキー コードが印刷できないか、有効なキーボード ショートカットに対応していない場合。 TRUE 指定したキー コードがドロップダウン メニュー オプションに対応する場合は 〗、それ以外の場合は 〘 の CMFCToolBar::ProcessCommand戻り値です。

解説

フレームワークは、Alt キーと共にキーを押すと、このメソッドを呼び出します。

CMFCToolBar::UpdateButton

指定したボタンの状態を更新します。

void UpdateButton(int nIndex);

パラメーター

nIndex
[in]更新するボタンの 0 から始まるインデックスを指定します。

解説

CMFCToolBar::WrapToolBar

指定した寸法内のツールバー ボタンの位置を変更します。

int WrapToolBar(
    int nWidth,
    int nHeight = 32767,
    CDC* pDC = NULL,
    int nColumnWidth = -1,
    int nRowHeight = -1);

パラメーター

nWidth
[in]ツールバーの最大幅。

nHeight
[in]ツールバーの最大高さ。 ツールバーが浮動状態の場合は使用されません。

pDC
[in]デバイス コンテキストへのポインター。 場合 NULLは、ツール バーのデバイス コンテキストが使用されます。

nColumnWidth
[in]ボタンの幅。 -1 の場合、現在の幅が使用されます。

[in] mnRowHeight ボタンの高さ。 -1 の場合、現在の高さが使用されます。

戻り値

ツール バーのボタンの行数。

解説

このメソッドは、ツール バー内のボタンの位置を変更し、必要に応じてボタンを追加の行に折り返します。

CMFCToolBar::m_bDontScaleImages

ツール バー イメージを高 DPI モードでスケーリングするかどうかを指定します。 イメージ サイズがボタン サイズと一致しない場合に、イメージのスケーリングを回避するように TRUE 設定します。

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

関連項目

階層図
クラス
CMFCMenuBar クラス
CMFCPopupMenuBar クラス
CMFCDropDownToolBar クラス
チュートリアル: ツール バーへのコントロールの追加