CMFCDropDownToolBar クラス

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

更新 : 2007 年 11 月

ユーザーがトップレベルのツールバーボタンを押し続けると表示されるツールバー。

class CMFCDropDownToolBar : public CMFCToolBar

メンバ

パブリックメソッド

名前	説明
CMFCDropDownToolBar::AllowShowOnPaneMenu	(CPane::AllowShowOnPaneMenu をオーバーライドします)。
CMFCDropDownToolBar::LoadBitmap	(CMFCToolBar::LoadBitmap をオーバーライドします)。
CMFCDropDownToolBar::LoadToolBar	(CMFCToolBar::LoadToolBar をオーバーライドします)。
CMFCDropDownToolBar::OnLButtonUp
CMFCDropDownToolBar::OnMouseMove
CMFCDropDownToolBar::OnSendCommand	(CMFCToolBar::OnSendCommand をオーバーライドします)。
CMFCDropDownToolBar::OnUpdateCmdUI	(CMFCToolBar::OnUpdateCmdUI をオーバーライドします)。

解説

CMFCDropDownToolBar オブジェクトは、ツールバーの外観をポップアップメニューの動作と組み合わせます。ユーザーがドロップダウンツールバーボタンを押し続けると (「CMFCDropDownToolbarButton クラス」を参照)、ドロップダウンツールバーが表示されます。ドロップダウンツールバーを目的のボタンまでスクロールしてマウスボタンを離すと、そのボタンを選択できます。ドロップダウンツールバーでユーザーがボタンを選択すると、そのボタンはトップレベルツールバーの現在のボタンとして表示されます。

ドロップダウンツールバーは、カスタマイズやドッキングができません。また、ティアオフ状態もありません。

次の図に、CMFCDropDownToolBar オブジェクトを示します。

CMFCDropDownToolbar スクリーンショット

CMFCDropDownToolBar オブジェクトを、通常のツールバーを作成するときと同じ方法で作成します (「CMFCToolBar クラス」参照)。

ドロップダウンツールバーを親ツールバーに挿入するには

1. 親ツールバーリソースでボタンのダミーリソース ID を予約します。

2. ドロップダウンツールバーを含む CMFCDropDownToolBarButton オブジェクトを作成します (詳細については、「CMFCDropDownToolbarButton::CMFCDropDownToolbarButton」を参照)。

3. CMFCToolBar::ReplaceButton を使用して、ダミーボタンを CMFCDropDownToolBarButton オブジェクトに置き換えます。

ツールバーボタンの詳細については、「方法 : ツールバーにコントロールを配置する」を参照してください。ドロップダウンツールバーの例については、サンプルプロジェクト VisualStudioDemo を参照してください。

使用例

CMFCDropDownToolBar クラスでの Create メソッドの使用方法を示す例を次に示します。このコードスニペットは、「VisualStudioDemo サンプル : MFC Visual Studio アプリケーション」の一部です。

  CMFCDropDownToolBar m_wndToolbarResource;


...


    // Create Resource toolbar:
    // The this pointer points to CMainFrame class which extends the CMDIFrameWndEx class
    if (!m_wndToolbarResource.Create(this, WS_CHILD|CBRS_TOP|CBRS_TOOLTIPS|CBRS_FLYBY|CBRS_HIDE_INPLACE|CBRS_SIZE_DYNAMIC| CBRS_GRIPPER | CBRS_BORDER_3D, IDR_TOOLBAR_RESOURCE) || !m_wndToolbarResource.LoadToolBar(IDR_TOOLBAR_RESOURCE))
    {
        TRACE0("Failed to create build toolbar\n");
        return FALSE;      // fail to create
    }