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 di 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 di CMFCRibbonBar

Grafico della gerarchia