CMFCDropDownToolBar クラス

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

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

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 メソッドの使用方法を示す例を次に示します。このコードスニペットは 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
    }