CMFCRibbonMainPanel 类
实现在单击 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。
继承层次结构
要求
标头: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;
返回值
一个表示功能区主面板区域的矩形。