CMFCDropDownToolBar クラス

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

詳細については、Visual Studio インストールの VC\atlmfc\src\mfc フォルダーにあるソース コードを参照してください。

構文

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ツール バーを作成するのと同じ方法で作成します (CMFCToolBar クラスを参照)。

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

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

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

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

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

例

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

継承階層

CObject

CCmdTarget

CWnd

CBasePane

Cpane

CMFCBaseToolBar

Cmfctoolbar

CMFCDropDownToolBar

必要条件

ヘッダー: afxdropdowntoolbar.h

CMFCDropDownToolBar::AllowShowOnPaneMenu

virtual BOOL AllowShowOnPaneMenu() const;

戻り値

解説

CMFCDropDownToolBar::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。

ブロック
[in]ツール バーをロックする場合は TRUE。それ以外の場合は FAL Standard Edition。

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

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

戻り値

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

解説

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

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

CMFCDropDownToolBar::LoadToolBar

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

パラメーター

[in] uiResID

[in] uiColdResID

[in] uiMenuResID

[in] Bool

[in] uiDisabledResID

[in] uiMenuDisabledResID

[in] uiHotResID

戻り値

解説

CMFCDropDownToolBar::OnLButtonUp

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

パラメーター

[in] Nflags

[入力] point

解説

CMFCDropDownToolBar::OnMouseMove

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

パラメーター

[in] Nflags

[入力] point

解説

CMFCDropDownToolBar::OnSendCommand

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

パラメーター

[in] pButton

戻り値

解説

CMFCDropDownToolBar::OnUpdateCmdUI

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

パラメーター

[入力] pTarget

[in] bDisableIfNoHndler

解説

関連項目

階層図
クラス
CMFCToolBar クラス
CMFCToolBar::Create
CMFCToolBar::ReplaceButton
CMFCDropDownToolbarButton クラス
チュートリアル: ツール バーへのコントロールの追加