CMFCRibbonSeparator 类

项目
10/12/2023

实现功能区分隔符。

语法

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] 文本与边框左侧之间的间距。

rect
[in] 指定边框。

bIsSelected
[in] 已忽略。

bHighlighted
[in] 已忽略。

另请参阅

层次结构图
 类

通过