CMFCDropDownFrame 類別

發行項
08/04/2024

提供下拉式框架視窗功能，以下拉式工具列和下拉式工具列按鈕。

語法

class CMFCDropDownFrame : public CMiniFrameWnd

成員

公用建構函式

名稱	描述
`CMFCDropDownFrame::CMFCDropDownFrame`	預設建構函式。
`CMFCDropDownFrame::~CMFCDropDownFrame`	解構函式。

公用方法

名稱	描述
CMFCDropDownFrame：：Create	建立 `CMFCDropDownFrame` 物件。
`CMFCDropDownFrame::CreateObject`	由建立此類別類型的動態執行個體架構所使用。
CMFCDropDownFrame：：GetParentMenuBar	擷取下拉式框架的父功能表欄。
CMFCDropDownFrame：：GetParentPopupMenu	擷取下拉式框架的父快捷功能表。
`CMFCDropDownFrame::GetThisClass`	由架構用來取得與這個類別類型相關聯之 CRuntimeClass 物件的指標。
CMFCDropDownFrame：：RecalcLayout	調整下拉式框架的位置。
CMFCDropDownFrame：：SetAutoDestroy	設定是否自動終結子下拉式工具列視窗。

備註

此類別不適合直接從您的程式代碼使用。

架構會使用此類別來提供和 CMFCDropDownToolbarButton 類別的框架行為CMFCDropDownToolbar。如需這些類別的詳細資訊，請參閱 CMFCDropDownToolBar 類別和 CMFCDropDownToolbarButton 類別。

範例

下列範例示範如何從CFrameWnd類別擷取物件的指標CMFCDropDownFrame，以及如何將子下拉式工具欄視窗設定為自動終結。

CFrameWnd *pTopFrame = AFXGetParentFrame(this);
if (pTopFrame == NULL)
{
   return FALSE;
}

CMFCDropDownFrame *pDropFrame = DYNAMIC_DOWNCAST(CMFCDropDownFrame, pTopFrame);
pDropFrame->SetAutoDestroy(true);

繼承階層架構

需求

標頭： afxdropdowntoolbar.h

CMFCDropDownFrame：：Create

建立 CMFCDropDownFrame 物件。

virtual BOOL Create(
    CWnd* pWndParent,
    int x,
    int y,
    CMFCDropDownToolBar* pWndOriginToolbar);

參數

pWndParent
[in]下拉式框架的父視窗。

x
[in]向下框架位置的水平螢幕座標。

y
[in]向下框架位置的垂直螢幕座標。

pWndOriginToolbar
[in]具有這個方法用來填入新下拉式框架物件的下拉式按鈕工具列。

傳回值

如果已成功建立下拉式框架，則為TRUE;否則為 FALSE。

備註

此方法會呼叫基底 CMiniFrameWnd：：CreateEx 方法，以使用WS_POPUP樣式建立下拉式框架視窗。下拉式框架視窗會出現在指定的螢幕座標上。如果 CMiniFrameWnd：：CreateEx 方法傳回 FALSE，這個方法就會失敗。

類別 CMFCDropDownFrame 會建立所提供 CMFCDropDownToolBar 參數的複本。這個方法會將按鈕影像和按鈕狀態從 pWndOriginToolbar 參數 m_pWndOriginToolbar 複製到數據成員。

CMFCDropDownFrame：：GetParentMenuBar

擷取下拉式框架的父功能表欄。

CMFCMenuBar* GetParentMenuBar() const;

傳回值

下拉式框架之父功能表欄的指標，如果框架沒有父代，則為 NULL。

備註

這個方法會從父按鈕擷取父功能表欄。如果下拉式方塊沒有父按鈕，或父按鈕沒有父功能表欄，這個方法會傳回NULL。

CMFCDropDownFrame：：GetParentPopupMenu

擷取下拉式框架的父快捷功能表。

CMFCDropDownFrame* GetParentPopupMenu() const;

傳回值

下拉式框架之父下拉功能表的指標，如果框架沒有父代，則為 NULL。

備註

這個方法會從父按鈕擷取父功能表。如果下拉式框架沒有父按鈕，或父按鈕沒有父功能表，這個方法會傳回 NULL。

CMFCDropDownFrame：：RecalcLayout

調整下拉式框架的位置。

virtual void RecalcLayout(BOOL bNotify = TRUE);

參數

bNotify
[in] 未使用。

備註

架構會在建立下拉式框架或調整父視窗大小時呼叫這個方法。這個方法會使用父視窗的位置和大小來計算下拉式框架的位置和大小。

CMFCDropDownFrame：：SetAutoDestroy

設定是否自動終結子下拉式工具列視窗。

void SetAutoDestroy(BOOL bAutoDestroy = TRUE);

參數

bAutoDestroy
[in]TRUE 可自動終結相關聯的下拉式工具列視窗;否則為 FALSE。

備註

如果 bAutoDestroy 為 TRUE，解 CMFCDropDownFrame 構函式會終結相關聯的下拉式工具列視窗。預設值為 TRUE。

另請參閱

階層架構圖表
 類別
 CMFCDropDownToolBar 類別
 CMFCDropDownToolbarButton 類別

共用方式為