CMFCRibbonUndoButton 類別

發行項
08/04/2024

類別 CMFCRibbonUndoButton 會實作包含最新使用者命令的下拉式清單按鈕。用戶可以從下拉式清單中選取一或多個最新的命令，以重做或復原它們。

語法

class CMFCRibbonUndoButton : public CMFCRibbonGallery

成員

公用建構函式

名稱	描述
CMFCRibbonUndoButton：：CMFCRibbonUndoButton	使用您從父物件影像清單指定的命令標識碼、文字標籤和影像，建構新的 `CMFCRibbonUndoButton` 物件。

公用方法

名稱	描述
CMFCRibbonUndoButton：：AddUndoAction	將新的動作新增至動作清單。
CMFCRibbonUndoButton：：CleanUpUndoList	清除動作清單，也就是下拉式清單。
CMFCRibbonUndoButton：：GetActionNumber	決定使用者從下拉式清單中選取的項目數目。
CMFCRibbonUndoButton：：HasMenu	指出物件是否包含功能表。

備註

類別 CMFCRibbonUndoButton 會使用堆疊來代表下拉式清單。

範例

下列範例示範如何建構類別的物件 CMFCRibbonUndoButton ，並將新的動作新增至動作清單。此代碼段是功能區小工具範例的一部分。

// 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

使用您從父物件影像清單指定的命令標識碼、文字標籤和影像，建構新的 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;

共用方式為