CMFCDropDownToolBar 類別

發行項
10/12/2023

當使用者按住最上層工具列按鈕時出現的工具列。

如需詳細資訊，請參閱 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 物件：

Example of CMFCDropDownToolbar.

CMFCDropDownToolBar您建立物件的方式與建立一般工具列的方式相同（請參閱 CMFCToolBar 類別）。

若要將下拉式工具列插入父工具列：

為父工具列資源的按鈕保留假的資源 ID。
建立 CMFCDropDownToolBarButton 包含下拉式工具列的物件（如需詳細資訊，請參閱 CMFCDropDownToolbarButton：：CMFCDropDownToolbarButton ）。
使用 CMFCToolBar：：ReplaceButton 將虛擬按鈕取代為 CMFCDropDownToolBarButton 物件。

如需工具列按鈕的詳細資訊，請參閱逐步解說：將控制項放在工具列上。如需下拉式工具列的範例，請參閱範例專案 VisualStudioDemo。

範例

下列範例示範如何在類別中使用 CreateCMFCDropDownToolBar 方法。此程式碼片段是 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
}

繼承階層架構

需求

標頭： 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]參考作用中工具列影像之點陣圖的資源識別碼。

uiColdResID
[in]參考冷工具列影像之點陣圖的資源識別碼。

uiMenuResID
[in]參考一般功能表影像之點陣圖的資源識別碼。

封鎖
[in]TRUE 可鎖定工具列;否則為 FALSE。

uiDisabledResID
[in]參考已停用工具列影像之點陣圖的資源識別碼。

uiMenuDisabledResID
[in]參考已停用功能表影像之點陣圖的資源識別碼。

傳回值

如果方法成功，則為非零，否則為零。

備註

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

[in] 點

備註

CMFCDropDownToolBar：：OnMouseMove

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

參數

[in] nFlags

[in] 點

備註

CMFCDropDownToolBar：：OnSendCommand

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

參數

[in] pButton

傳回值

備註

CMFCDropDownToolBar：：OnUpdateCmdUI

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

參數

[in] pTarget

[in] bDisableIfNoHndler

備註

另請參閱

階層架構圖表
 類別
 CMFCToolBar 類別
 CMFCToolBar：：Create
CMFCToolBar：：ReplaceButton
CMFCDropDownToolbarButton 類別
 逐步解說：將控制項放在工具列上

共用方式為