Compartilhar via


Classe CMFCRibbonUndoButton

A classe CMFCRibbonUndoButton implementa um botão de lista suspensa que contém os comandos do usuário mais recentes. Os usuários podem selecionar um ou mais dos comandos mais recentes na lista suspensa para refazê-los ou desfazê-los.

Sintaxe

class CMFCRibbonUndoButton : public CMFCRibbonGallery

Membros

Construtores públicos

Nome Descrição
CMFCRibbonUndoButton::CMFCRibbonUndoButton Constrói um novo objeto CMFCRibbonUndoButton usando a ID de comando especificada, o rótulo de texto e as imagens da lista de imagens do objeto pai.

Métodos públicos

Nome Descrição
CMFCRibbonUndoButton::AddUndoAction Adiciona uma nova ação à lista de ações.
CMFCRibbonUndoButton::CleanUpUndoList Limpa a lista de ações, que é a lista suspensa.
CMFCRibbonUndoButton::GetActionNumber Determina o número de itens que um usuário selecionou na lista suspensa.
CMFCRibbonUndoButton::HasMenu Indica se o objeto contém um menu.

Comentários

A classe CMFCRibbonUndoButton usa uma pilha para representar a lista suspensa.

Exemplo

O exemplo a seguir demonstra como construir um objeto da classe CMFCRibbonUndoButton e adiciona uma nova ação à lista de ações. Este snippet de código faz parte do Exemplo de Gadgets da Faixa de Opções.

// 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);
}

Hierarquia de herança

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonGallery

CMFCRibbonUndoButton

Requisitos

Cabeçalho: afxribbonundobutton.h

CMFCRibbonUndoButton::AddUndoAction

Adiciona uma nova ação à lista de ações.

void AddUndoAction(LPCTSTR lpszLabel);

Parâmetros

lpszLabel
[in] O rótulo de ação que será exibido na lista suspensa.

CMFCRibbonUndoButton::CleanUpUndoList

Limpa a lista de ações, que é a lista suspensa.

void CleanUpUndoList();

CMFCRibbonUndoButton::CMFCRibbonUndoButton

Constrói um novo objeto CMFCRibbonUndoButton usando a ID de comando especificada, o rótulo de texto e as imagens da lista de imagens do objeto pai.

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

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

Parâmetros

Nid
[in] Especifica o identificador do comando.

lpszTexto
[in] Especifica o rótulo de texto do botão.

nSmallImageIndex
[in] Índice baseado em zero na lista de imagens do objeto pai para a imagem em miniatura do botão.

nLargeImageIndex
[in] Índice baseado em zero na lista de imagens do objeto pai para a imagem grande do botão.

hIcon
[in] Um identificador para um ícone que você pode usar como imagem de um botão.

CMFCRibbonUndoButton::GetActionNumber

Determina o número de itens que um usuário selecionou na lista suspensa.

int GetActionNumber() const;

Valor de retorno

O número de itens que um usuário selecionou.

CMFCRibbonUndoButton::HasMenu

Indica se o objeto contém um menu.

virtual BOOL HasMenu() const;

Valor de retorno

Sempre retorna TRUE.

Comentários

Confira também

Gráfico da hierarquia
Classes
Classe CMFCRibbonGallery
Classe CMFCRibbonButton