CMFCRibbonMainPanel 类

项目
06/16/2023

实现在单击 CMFCRibbonApplicationButton 时显示的功能区面板。

语法

class CMFCRibbonMainPanel : public CMFCRibbonPanel

成员

公共构造函数

名称	描述
`CMFCRibbonMainPanel::CMFCRibbonMainPanel`	默认构造函数。
`CMFCRibbonMainPanel::~CMFCRibbonMainPanel`	析构函数。

公共方法

名称	描述
CMFCRibbonMainPanel::Add	将功能区元素添加到应用程序按钮面板的左窗格中。（替代 CMFCRibbonPanel::Add。）
CMFCRibbonMainPanel::AddRecentFilesList	将文本字符串添加到最近的文件列表菜单。
CMFCRibbonMainPanel::AddToBottom	将功能区元素添加到功能区应用程序面板的底部窗格。
CMFCRibbonMainPanel::AddToRight	将功能区元素添加到应用程序按钮面板的右窗格中。
`CMFCRibbonMainPanel::CreateObject`	由框架用于创建此类类型的动态实例。
CMFCRibbonMainPanel::GetCommandsFrame	返回一个表示功能区主面板区域的矩形。
`CMFCRibbonMainPanel::GetThisClass`	由框架用于获取指向与此类类型关联的 CRuntimeClass 对象的指针。

备注

框架会在打开应用程序面板时显示 CMFCRibbonMainPanel。其中包含三个窗格：

左窗格包含与文件相关的命令，例如“打开”、“保存”、“打印”和“关闭”。要将命令添加到此窗格，请调用 CMFCRibbonMainPanel::Add。
右窗格包含修改在左窗格单击的命令的选项。例如，如果从左窗格单击“另存为”，则右窗格会显示可用的文件类型。要向此窗格添加项，请调用 CMFCRibbonMainPanel::AddToRight。
底部窗格包含用于更改应用程序设置和退出程序的按钮。要向此窗格添加项，请调用 CMFCRibbonMainPanel::AddToBottom。

继承层次结构

CObject

CMFCRibbonPanel

CMFCRibbonMainPanel

要求

标头：afxRibbonMainPanel.h

CMFCRibbonMainPanel::Add

将功能区元素添加到应用程序按钮面板的左窗格中。

virtual void Add(CMFCRibbonBaseElement* pElem);

参数

pElem
[in, out] 指向要添加到主面板的功能区元素的指针。

注解

将功能区元素添加到面板。使用此方法添加的元素将位于主面板的左列。

CMFCRibbonMainPanel::AddRecentFilesList

将文本字符串添加到最近的文件列表菜单。

void AddRecentFilesList(
    LPCTSTR lpszLabel,
    int nWidth = 300);

参数

lpszLabel
指定要添加到最近文件列表的字符串。

nWidth
指定最近文件列表面板的宽度（以像素为单位）。

备注

CMFCRibbonMainPanel::AddToBottom

将功能区元素添加到功能区应用程序面板的底部窗格。

void AddToBottom(CMFCRibbonMainPanelButton* pElem);

参数

pElem
[in, out] 指向要添加到主面板底部的功能区元素的指针。

备注

CMFCRibbonMainPanel::AddToRight

将功能区元素添加到应用程序按钮面板的右窗格中。

void AddToRight(
    CMFCRibbonBaseElement* pElem,
    int nWidth = 300);

参数

pElem
指向要添加到主面板右侧的功能区元素的指针。

nWidth
指定右面板的宽度（以像素为单位）。

注解

使用此函数可将功能区元素添加到右面板。右面板通常显示最近的文件列表，但也可在此处添加任何其他功能区元素。

CMFCRibbonMainPanel::GetCommandsFrame

返回一个表示功能区主面板区域的矩形。

CRect GetCommandsFrame() const;

返回值

一个表示功能区主面板区域的矩形。

另请参阅

层次结构图
 类
 CMFCRibbonPanel 类

Share via