CMFCMenuBar クラス

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ドッキングを実装するメニューバー。

class CMFCMenuBar : public CMFCToolbar

メンバ

パブリックメソッド

名前	説明
CMFCMenuBar::AdjustLocations	(CMFCToolBar::AdjustLocations をオーバーライドします)。
CMFCMenuBar::AllowChangeTextLabels	ツールバーボタンでイメージの下のテキストラベルが表示されているかどうかを示します (CMFCToolBar::AllowChangeTextLabels をオーバーライドします)。
CMFCMenuBar::AllowShowOnPaneMenu	(CPane::AllowShowOnPaneMenu をオーバーライドします)。
CMFCMenuBar::CalcFixedLayout	ツールバーの水平サイズを計算します (CMFCToolBar::CalcFixedLayout をオーバーライドします)。
CMFCMenuBar::CalcLayout	(CMFCToolBar::CalcLayout をオーバーライドします)。
CMFCMenuBar::CalcMaxButtonHeight	ツールバーのボタンの高さの最大値を計算します (CMFCToolBar::CalcMaxButtonHeight をオーバーライドします)。
CMFCMenuBar::CanBeClosed	ユーザーがツールバーを閉じることができるかどうかを示します (CMFCToolBar::CanBeClosed をオーバーライドします)。
CMFCMenuBar::CanBeRestored	カスタマイズ後にツールバーを元の状態に復元できるかどうかを判断します (CMFCToolBar::CanBeRestored をオーバーライドします)。
CMFCMenuBar::Create	メニューコントロールを作成し、CMFCMenuBar オブジェクトにアタッチします。
CMFCMenuBar::CreateEx	CMFCMenuBar オブジェクトを作成します。追加のスタイルオプションを指定します。
CMFCMenuBar::CreateFromMenu	CMFCMenuBar オブジェクトを初期化します。取得された CMFCMenuBar のテンプレートとして動作する HMENU パラメータを受け入れます。
CMFCMenuBar::EnableHelpCombobox	メニューバーの右側にある [ヘルプ] ボックスを有効にします。
CMFCMenuBar::EnableMenuShadows	ポップアップメニューの影を表示するかどうかを指定します。
CMFCMenuBar::GetAvailableExpandSize	(CPane::GetAvailableExpandSize をオーバーライドします)。
CMFCMenuBar::GetColumnWidth	ツールバーボタンの幅を返します。(CMFCToolBar::GetColumnWidth をオーバーライドします)。
CMFCMenuBar::GetDefaultMenu	リソースファイルでの元のメニューのハンドルを返します。
CMFCMenuBar::GetDefaultMenuResId	リソースファイルでの元のメニューのリソース識別子を返します。
CMFCMenuBar::GetFloatPopupDirection
CMFCMenuBar::GetForceDownArrows
CMFCMenuBar::GetHelpCombobox	[ヘルプ] ボックスへのポインタを返します。
CMFCMenuBar::GetHMenu	CMFCMenuBar オブジェクトにアタッチされているメニューのハンドルを返します。
CMFCMenuBar::GetMenuFont	メニューオブジェクトの現在のグローバルフォントを返します。
CMFCMenuBar::GetMenuItem	指定された項目のインデックスに関連付けられたツールバーボタンを返します。
CMFCMenuBar::GetRowHeight	ツールバーボタンの高さを返します (CMFCToolBar::GetRowHeight をオーバーライドします)。
CMFCMenuBar::GetMenuItem
CMFCMenuBar::GetSystemButtonsCount
CMFCMenuBar::GetSystemMenu
CMFCMenuBar::HighlightDisabledItems	無効なメニュー項目を強調表示するかどうかを示します。
CMFCMenuBar::IsButtonExtraSizeAvailable	拡張された境界を持つボタンをツールバーが表示できるかどうかを判断します (CMFCToolBar::IsButtonExtraSizeAvailable をオーバーライドします)。
CMFCMenuBar::IsHighlightDisabledItems	無効な項目を強調表示するかどうかを指定します。
CMFCMenuBar::IsMenuShadows	ポップアップメニューの影を描画するかどうかを指定します。
CMFCMenuBar::IsRecentlyUsedMenus	最近使用したメニューコマンドがメニューバーに表示されているかどうかを示します。
CMFCMenuBar::IsShowAllCommands	ポップアップメニューにすべてのコマンドを表示するかどうかを指定します。
CMFCMenuBar::IsShowAllCommandsDelay	少し時間が経つとメニューにすべてのコマンドを表示するかどうかを指定します。
CMFCMenuBar::LoadState	レジストリから CMFCMenuBar オブジェクトの状態を読み込みます。
CMFCMenuBar::OnChangeHot	ツールバー上のボタンが選択されたときに、フレームワークによって呼び出されます (CMFCToolBar::OnChangeHot をオーバーライドします)。
CMFCMenuBar::OnDefaultMenuLoaded	フレームウィンドウがリソースファイルから既定のメニューを読み込んだときに、フレームワークによって呼び出されます。
CMFCMenuBar::OnSendCommand	(CMFCToolBar::OnSendCommand をオーバーライドします)。
CMFCMenuBar::OnSetDefaultButtonText	メニューがカスタマイズモードで、ユーザーがメニュー項目のテキストを変更したときに、フレームワークによって呼び出されます。
CMFCMenuBar::OnToolHitTest	(CMFCToolBar::OnToolHitTest をオーバーライドします)。
CMFCMenuBar::PreTranslateMessage	(CMFCToolBar::PreTranslateMessage をオーバーライドします)。
CMFCMenuBar::RestoreOriginalstate	メニューがカスタマイズモードで、ユーザーがメニューバーの [リセット] をクリックしたときに、フレームワークによって呼び出されます。
CMFCMenuBar::SaveState	CMFCMenuBar オブジェクトの状態をレジストリに保存します。
CMFCMenuBar::SetDefaultMenuResId	リソースファイルに元のメニューを設定します。
CMFCMenuBar::SetForceDownArrows
CMFCMenuBar::SetMaximizeMode	MDI 子ウィンドウの表示モードが変更されたときに、フレームワークによって呼び出されます。MDI 子ウィンドウが新たに最大化されるか、それ以上最大化できない場合、このメソッドはメニューバーを更新します。
CMFCMenuBar::SetMenuButtonRTC	ユーザーがメニューボタンを動的に作成するときに生成されるランタイムクラス情報を設定します。
CMFCMenuBar::SetMenuFont	アプリケーション内のすべてのメニューのフォントを設定します。
CMFCMenuBar::SetRecentlyUsedMenus	最近使用したメニューコマンドをメニューバーに表示するかどうかを指定します。
CMFCMenuBar::SetShowAllCommands	メニューバーにすべてのコマンドを表示するかどうかを指定します。

解説

CMFCMenuBar クラスは、ドッキング機能を実装するメニューバーです。これはツールバーに似ています。ただし、閉じることはできません (常に表示されています)。

CMFCMenuBar は、最近使用されたメニュー項目オブジェクトを表示するオプションをサポートします。このオプションが有効な場合、CMFCMenuBar は、使用できるコマンドのサブセットのみを最初の画面に表示します。その後、最近使用されたコマンドが元のコマンドのサブセットと一緒に表示されます。また、ユーザーはいつでもメニューを拡張して、使用できるすべてのコマンドを表示できます。したがって、使用できる各コマンドに対して、常に表示するか、最近使用された場合のみ表示するかを設定します。

CMFCMenuBar オブジェクトを使用するには、これをメインウィンドウフレームオブジェクトに埋め込みます。WM_CREATE メッセージを処理する場合は、CMFCMenuBar::Create または CMFCMenuBar::CreateEx を呼び出します。使用する作成関数に関係なくメインフレームウィンドウへのポインタに渡されます。次に、CFrameWndEx::EnableDocking を呼び出してドッキングを有効にします。CFrameWndEx::DockPane を呼び出して、このメニューをドッキングします。

使用例

次の例は、CMFCMenuBar クラスのさまざまなメソッドの使用方法を説明しています。例では、ペインのスタイルの設定、カスタマイズボタンの有効化、[ヘルプ] ボックスの有効化、ポップアップメニューの影の有効化、およびメニューバーの更新について、その方法を説明しています。このコードスニペットは、「IEDemo サンプル : MFC Internet Explorer アプリケーション」の一部です。

  CMFCMenuBar m_wndMenuBar;


...


    m_wndMenuBar.SetPaneStyle(m_wndMenuBar.GetPaneStyle() | CBRS_SIZE_DYNAMIC);
    m_wndMenuBar.EnableCustomizeButton (TRUE, -1, _T(""));
    // first parameter is the command ID for the button of the Help combo box
    // third parameter is the width of the button for the combo box in pixels.
    m_wndMenuBar.EnableHelpCombobox(1,_T("enter text here"),30);
    m_wndMenuBar.EnableMenuShadows();
    m_wndMenuBar.SetMaximizeMode(true);