CMFCRibbonUndoButton 类

项目
10/18/2023

CMFCRibbonUndoButton 类实现包含最新用户命令的下拉列表按钮。用户可从下拉列表中选择一个或多个最新命令，以重做或撤消它们。

语法

class CMFCRibbonUndoButton : public CMFCRibbonGallery

成员

公共构造函数

名称	描述
CMFCRibbonUndoButton::CMFCRibbonUndoButton	使用指定的命令 ID 和来自父对象图像列表的文本标签和图像构造一个新的 `CMFCRibbonUndoButton` 对象。

公共方法

名称	描述
CMFCRibbonUndoButton::AddUndoAction	向操作列表添加新操作。
CMFCRibbonUndoButton::CleanUpUndoList	清除操作列表（这是一个下拉列表）。
CMFCRibbonUndoButton::GetActionNumber	确定用户从下拉列表中选择的项数。
CMFCRibbonUndoButton::HasMenu	指示对象是否包含菜单。

备注

CMFCRibbonUndoButton 类使用堆栈来表示下拉列表。

示例

以下示例演示如何构造 CMFCRibbonUndoButton 类的对象，以及如何向操作列表添加新操作。此代码片段属于 Ribbon Gadgets 示例。

// The third parameter is the zero-based index in the image list of the parent
// object for the button's small image.
// The fourth parameter is the zero-based index in the image list of the parent object
// for the of button's large image.
CMFCRibbonUndoButton *pBtn1 = new CMFCRibbonUndoButton(ID_RIBBON_OBTN_1, _T("Undo"), 0, 0);
for (int i = 0; i < 20; i++)
{
   CString str;
   str.Format(_T("Action %d"), i + 1);
   pBtn1->AddUndoAction(str);
}

继承层次结构

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonGallery

CMFCRibbonUndoButton

要求

标头：afxribbonundobutton.h

CMFCRibbonUndoButton::AddUndoAction

向操作列表添加新操作。

void AddUndoAction(LPCTSTR lpszLabel);

参数

lpszLabel
[in] 将在下拉列表中显示的操作标签。

CMFCRibbonUndoButton::CleanUpUndoList

清除操作列表（这是一个下拉列表）。

void CleanUpUndoList();

CMFCRibbonUndoButton::CMFCRibbonUndoButton

使用指定的命令 ID 和来自父对象图像列表的文本标签和图像构造一个新的 CMFCRibbonUndoButton 对象。

CMFCRibbonUndoButton(
    UINT nID,
    LPCTSTR lpszText,
    int nSmallImageIndex=-1,
    int nLargeImageIndex=-1);

CMFCRibbonUndoButton(
    UINT nID,
    LPCTSTR lpszText,
    HICON hIcon);

参数

nID
[in] 指定命令标识符。

lpszText
[in] 指定按钮的文本标签。

nSmallImageIndex
[in] 按钮小图像的父对象图像列表中的从零开始的索引。

nLargeImageIndex
[in] 按钮大图像的父对象图像列表中的从零开始的索引。

hIcon
[in] 可用作按钮图像的图标的图柄。

CMFCRibbonUndoButton::GetActionNumber

确定用户从下拉列表中选择的项数。

int GetActionNumber() const;

返回值

用户选择的项的数量。

CMFCRibbonUndoButton::HasMenu

指示对象是否包含菜单。

virtual BOOL HasMenu() const;

通过