CMFCRibbonBar::AddCategory
Crée et initialise une nouvelle catégorie ruban pour la barre de ruban.
CMFCRibbonCategory* AddCategory(
LPCTSTR lpszName,
UINT uiSmallImagesResID,
UINT uiLargeImagesResID,
CSize sizeSmallImage = CSize(16, 16),
CSize sizeLargeImage = CSize(32, 32),
int nInsertAt = -1,
CRuntimeClass* pRTI = NULL
);
Paramètres
[in] lpszName
Nom de la catégorie ruban.[in] uiSmallImagesResID
ID de ressource de la petite liste d'images pour la catégorie ruban.[in] uiLargeImagesResID
ID de ressource de la grande liste d'images pour la catégorie ruban.[in] sizeSmallImage
Spécifie la taille de petites images pour la catégorie ruban.[in] sizeLargeImage
Spécifie la taille de grandes icônes pour la catégorie ruban.[in] nInsertAt
Index de base zéro de l'emplacement de catégorie.[in] pRTI
Pointeur vers une classe d'exécution de CMFCRibbonCategory, classe pour créer dynamiquement une catégorie ruban au moment de l'exécution.
Valeur de retour
Un pointeur vers la nouvelle catégorie ruban si la méthode a réussi ; sinon, NULL.
Notes
Si le paramètre d' pRTI n'est pas NULL, la nouvelle catégorie ruban est créée dynamiquement à l'aide de la classe d'exécution.
Exemple
L'exemple suivant montre comment utiliser la méthode d' AddCategory dans la classe d' CMFCRibbonBar .
// Add "Home" category.
// CMFCRibbonBar m_wndRibbonBar
strTemp.LoadString(IDS_RIBBON_HOME);
CMFCRibbonCategory* pCategoryHome = m_wndRibbonBar.AddCategory(strTemp,
IDB_WRITESMALL, IDB_WRITELARGE);
Configuration requise
en-tête : afxribbonbar.h