Partager via


CMFCRibbonBar::AddContextCategory

Crée et initialise une nouvelle catégorie de contexte pour la barre de ruban.

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 
);

Paramètres

  • [in] lpszName
    Nom de la catégorie.

  • [in] lpszContextName
    Nom de la légende de la catégorie de contexte.

  • [in] uiContextID
    ID de contexte

  • [in] clrContext
    Couleur de la légende de la catégorie de contexte.

  • [in] uiSmallImagesResID
    ID de ressource de la petite image d'une catégorie de contexte.

  • [in] uiLargeImagesResID
    ID de ressource de la grande image d'une catégorie de contexte.

  • [in] sizeSmallImage
    Taille d'une petite image.

  • [in] sizeLargeImage
    Taille d'une grande image.

  • [in] pRTI
    Pointeur vers une classe d'exécution.

Valeur de retour

Un pointeur à la catégorie récemment créée, ou NULL si la méthode d' CreateObject d' pRTI ne peut pas créer la catégorie spécifiée.

Notes

Utilisez cette fonction pour ajouter une catégorie de contexte. Les catégories de contexte sont un type particulier de catégorie qui peut être affiché ou masqué au moment de l'exécution, selon le contexte actuel d'application. Par exemple, lorsque l'utilisateur sélectionne un objet, vous pouvez afficher les onglets spéciaux avec les catégories de contexte utilisé pour modifier l'objet sélectionné spécifiques.

La couleur d'une catégorie de contexte peut avoir l'une des valeurs suivantes :

  • AFX_CategoryColor_None

  • AFX_CategoryColor_Red

  • AFX_CategoryColor_Orange

  • AFX_CategoryColor_Yellow

  • AFX_CategoryColor_Green

  • AFX_CategoryColor_Blue

  • AFX_CategoryColor_Indigo

  • AFX_CategoryColor_Violet

Configuration requise

en-tête : afxribbonbar.h

Voir aussi

Référence

CMFCRibbonBar, classe

Graphique de la hiérarchie