Condividi tramite


CMFCRibbonBar::AddContextCategory

Crea e inizializza una nuova categoria di contesto per la barra multifunzione.

CMFCRibbonCategory* AddContextCategory(
   LPCTSTR lpszName,
   LPCTSTR lpszContextName,
   UINT uiContextID,
   AFX_RibbonCategoryColor clrContext,
   UINT uiSmallImagesResID,
   UINT uiLargeImagesResID,
   CSize sizeSmallImage = CSize(16, 16),
   CSize sizeLargeImage = CSize(32, 32),
   CRuntimeClass* pRTI = NULL 
);

Parametri

  • [in] lpszName
    Nome della categoria.

  • [in] lpszContextName
    Nome della didascalia di categoria di contesto.

  • [in] uiContextID
    Identificazione di contesto

  • [in] clrContext
    Colore della didascalia di categoria di contesto.

  • [in] uiSmallImagesResID
    ID di risorsa di immagine piccola di una categoria di contesto.

  • [in] uiLargeImagesResID
    ID di risorsa di immagine grande di una categoria di contesto.

  • [in] sizeSmallImage
    Dimensione di immagine piccola.

  • [in] sizeLargeImage
    Dimensione di immagine grande.

  • [in] pRTI
    Puntatore a una classe di runtime.

Valore restituito

Un puntatore alla categoria appena creato, o NULL se il metodo CreateObjectpRTI impossibile creare la categoria specificata.

Note

Utilizzare questa funzione per aggiungere una categoria di contesto.Le categorie di contesto sono un tipo speciale di categoria che può essere visualizzato o nascosto in fase di esecuzione, a seconda del contesto dell'applicazione corrente.Ad esempio, quando l'utente seleziona un oggetto, è possibile visualizzare schede speciali con le categorie di contesto utilizzato per modificare l'oggetto selezionato specifico.

Il colore di una categoria di contesto può essere uno dei seguenti valori:

  • AFX_CategoryColor_None

  • AFX_CategoryColor_Red

  • AFX_CategoryColor_Orange

  • AFX_CategoryColor_Yellow

  • AFX_CategoryColor_Green

  • AFX_CategoryColor_Blue

  • AFX_CategoryColor_Indigo

  • AFX_CategoryColor_Violet

Requisiti

intestazione: afxribbonbar.h

Vedere anche

Riferimenti

Classe di CMFCRibbonBar

Grafico della gerarchia