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 配置和新增分隔符。
繼承階層架構
需求
標頭： 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]文字與周框左側之間的間距。
rect
[in]指定周框。
bIsSelected
[in]忽視。
bHighlighted
[in]忽視。