Condividi tramite


CMFCRibbonBar::AddCategory

Crea e inizializza una nuova categoria della barra multifunzione per la barra multifunzione.

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

Parametri

  • [in] lpszName
    Nome della categoria della barra multifunzione.

  • [in] uiSmallImagesResID
    ID di risorsa di piccolo elenco immagini per categoria della barra multifunzione.

  • [in] uiLargeImagesResID
    ID di risorsa di grandi dimensioni elenco immagini per categoria della barra multifunzione.

  • [in] sizeSmallImage
    Specifica le dimensioni delle immagini per categoria della barra multifunzione.

  • [in] sizeLargeImage
    Specifica la dimensione di immagini di grandi dimensioni alla categoria della barra multifunzione.

  • [in] nInsertAt
    Indice in base zero della posizione della categoria.

  • [in] pRTI
    Puntatore a una classe di runtime Classe CMFCRibbonCategory per creare dinamicamente una categoria barra multifunzione in fase di esecuzione.

Valore restituito

Un puntatore alla nuova categoria della barra multifunzione se il metodo è riuscita, in caso contrario, NULL.

Note

Se il parametro pRTI non è NULL, la nuova categoria della barra multifunzione viene creata dinamicamente utilizzando la classe di runtime.

Esempio

Il seguente esempio viene illustrato come utilizzare il metodo AddCategory nella classe CMFCRibbonBar.

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

Requisiti

intestazione: afxribbonbar.h

Vedere anche

Riferimenti

Classe CMFCRibbonBar

Grafico delle gerarchie