CMFCRibbonSeparator 類別

實作功能區分隔符號。

語法

class CMFCRibbonSeparator : public CMFCRibbonBaseElement

成員

公用建構函式

名稱	描述
CMFCRibbonSeparator：：CMFCRibbonSeparator	建構 CMFCRibbonSeparator 物件。

公用方法

名稱	描述
CMFCRibbonSeparator：：AddToListBox	將分隔符號新增至 [自訂 ] 對話方塊中的 [命令 ] 清單。 （覆寫 CMFCRibbonBaseElement：：AddToListBox .）
CMFCRibbonSeparator::CreateObject	由建立此類別類型的動態執行個體架構所使用。
CMFCRibbonSeparator::GetThisClass	由架構用來取得與這個類別類型相關聯之 CRuntimeClass 物件的指標。

受保護的方法

名稱	描述
CMFCRibbonSeparator：：CopyFrom	複製方法，設定另一個物件的分隔符號成員變數。
CMFCRibbonSeparator：：GetRegularSize	傳回分隔符號的大小。
CMFCRibbonSeparator：：IsSeparator	指出這是否為分隔符號。
CMFCRibbonSeparator：：IsTabStop	指出這是否為定位停駐點。
CMFCRibbonSeparator：：OnDraw	由系統呼叫，以在功能區或快速存取工具列上繪製分隔符號。
CMFCRibbonSeparator：：OnDrawOnList	由系統呼叫，以在 [命令 ] 清單上 繪製分隔符號。

備註

功能區分隔符號是邏輯上分隔功能區元素的垂直或水平線。 分隔符號可以在功能區控制項、主要應用程式功能表、功能區狀態列和快速存取工具列上繪製。

若要在應用程式中使用分隔符號，請建構新的 物件，並將其新增至主要應用程式功能表，如下所示：

CMFCRibbonMainPanel* pMainPanel = m_wndRibbonBar.AddMainCategory(_T("Main Menu"),
    IDB_FILESMALL,
    IDB_FILELARGE);

...
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));

呼叫 CMFCRibbonPanel：：AddSeparator ，將分隔符號新增至功能區面板。 方法會在內部 AddSeparator 配置和新增分隔符號。

繼承階層架構

CObject

CMFCRibbonBaseElement

CMFCRibbonSeparator

需求

標頭： afxbaseribbonelement.h

CMFCRibbonSeparator：：AddToListBox

將分隔符號新增至 [自訂 ] 對話方塊中的 [命令 ] 清單。

virtual int AddToListBox(
    CMFCRibbonCommandsListBox* pWndListBox,
    BOOL bDeep);

參數

pWndListBox
[in]新增分隔符號之 命令 清單的指標。

bDeep
[in]忽視。

傳回值

以零起始的索引到 pWndListBox 所 指定清單方塊中的字串。

CMFCRibbonSeparator：：CMFCRibbonSeparator

建構 CMFCRibbonSeparator 物件。

CMFCRibbonSeparator(BOOL bIsHoriz = FALSE);

參數

bIsHoriz
[in]如果為 TRUE，則分隔符號為水準;如果為 FALSE，則分隔符號為垂直。

備註

水準分隔符號用於應用程式功能表。 垂直分隔符號用於工具列中。

範例

下列範例示範如何建構 類別的物件 CMFCRibbonSeparator 。

// CMFCRibbonMainPanel* pMainPanel
pMainPanel->Add(new CMFCRibbonSeparator(TRUE));

CMFCRibbonSeparator：：CopyFrom

複製方法，設定另一個物件的分隔符號成員變數。

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

參數

Src
[in]要複製的來源功能區專案。

CMFCRibbonSeparator：：GetRegularSize

傳回分隔符號的大小。

virtual CSize GetRegularSize(CDC* pDC);

參數

pDC
[in]裝置內容的指標。

傳回值

指定裝置內容上的分隔符號大小。

CMFCRibbonSeparator：：IsSeparator

指出這是否為分隔符號。

virtual BOOL IsSeparator() const;

傳回值

這個類別的一律為 TRUE。

CMFCRibbonSeparator：：IsTabStop

指出這是否為定位停駐點。

virtual BOOL IsTabStop() const;

傳回值

這個類別的一律為 FALSE。

備註

功能區分隔符號不是定位停駐點。

CMFCRibbonSeparator：：OnDraw

由系統呼叫，以在功能區或快速存取工具列上繪製分隔符號。

virtual void OnDraw(CDC* pDC);

參數

pDC
[in]裝置內容的指標。

CMFCRibbonSeparator：：OnDrawOnList

由系統呼叫，以在 [命令 ] 清單上 繪製分隔符號。

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

參數

pDC
[in]裝置內容的指標。

strText
[in]顯示在清單上的文字。

nTextOffset
[in]文字與周框左側之間的間距。

矩形
[in]指定周框。

bIsSelected
[in]忽視。

bHighlighted
[in]忽視。

另請參閱

階層架構圖表
類別