Compartilhar via


CMFCRibbonBar::AddCategory

Adicionar uma nova categoria da faixa de opções de opções para a faixa de opções.

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

Parâmetros

  • [in] lpszName
    Nome da categoria para adicionar.

  • [in] uiSmallImagesResID
    ID de recurso de imagens pequenas.

  • [in] uiLargeImagesResID
    ID de recurso de imagens grandes.

  • [in] sizeSmallImage
    Especifica o dimensionar das imagens pequenas.

  • [in] sizeLargeImage
    Especifica o dimensionar das imagens grandes.

  • [no]. nInsertAt
    Zero índice com base para a categoria em Inserir.

  • [no]. pRTI
    Ponteiro para a classe de tempo de execução.

Valor de retorno

Um ponteiro para a categoria recém-criada, ou NULL Se pRTI não é nulo e seu método CreateObject não é possível criar a categoria em tempo de execução devido à memória insuficiente.

Comentários

Use esta função para adicionar uma nova categoria da faixa de opções de opções.É possível configurar a categoria usando o ponteiro retornado.

Exemplo

O exemplo a seguir demonstra como usar o AddCategory método na CMFCRibbonBar classe.

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

Conceitos

Gráfico de hierarquia do MFC

Referência

Classe CMFCRibbonBar