Compartilhar via


CMFCRibbonBar::AddCategory

Cria e inicializa uma nova categoria de fita para a barra de fita.

CMFCRibbonCategory* AddCategory(
   LPCTSTR lpszName,
   UINT uiSmallImagesResID,
   UINT uiLargeImagesResID,
   CSize sizeSmallImage = CSize(16, 16),
   CSize sizeLargeImage = CSize(32, 32),
   int nInsertAt = -1,
   CRuntimeClass* pRTI = NULL 
);

Parâmetros

  • [in] lpszName
    Nome de categoria de fita.

  • [in] uiSmallImagesResID
    Identificação do recurso de pequena lista de imagem para a categoria de fita.

  • [in] uiLargeImagesResID
    Identificação do recurso de grande lista de imagem para a categoria de fita.

  • [in] sizeSmallImage
    Especifica o tamanho de imagens pequenas para a categoria de fita.

  • [in] sizeLargeImage
    Especifica o tamanho de grandes imagens para a categoria de fita.

  • [in] nInsertAt
    Índice com base zero do local de categoria.

  • [in] pRTI
    Ponteiro para uma classe de tempo de execução de Classe de CMFCRibbonCategory para criar dinamicamente uma categoria de fita em tempo de execução.

Valor de retorno

Um ponteiro para a nova categoria de fita se o método tenha êxito; caso contrário, NULL.

Comentários

Se o parâmetro de pRTI não é NULL, a nova categoria de fita é criada dinamicamente usando a classe de tempo de execução.

Exemplo

O exemplo seguinte demonstra como usar o método de AddCategory na classe de CMFCRibbonBar .

    // Add "Home" category.
    // CMFCRibbonBar m_wndRibbonBar
    strTemp.LoadString(IDS_RIBBON_HOME);
    CMFCRibbonCategory* pCategoryHome = m_wndRibbonBar.AddCategory(strTemp, 
        IDB_WRITESMALL, IDB_WRITELARGE);

Requisitos

Cabeçalho: afxribbonbar.h

Consulte também

Referência

Classe de CMFCRibbonBar

Gráfico de hierarquia