CMFCRibbonBar::AddCategory
Erstellt und initialisiert eine neue Menübandkategorie für die Menübandleiste.
CMFCRibbonCategory* AddCategory(
LPCTSTR lpszName,
UINT uiSmallImagesResID,
UINT uiLargeImagesResID,
CSize sizeSmallImage = CSize(16, 16),
CSize sizeLargeImage = CSize(32, 32),
int nInsertAt = -1,
CRuntimeClass* pRTI = NULL
);
Parameter
[in] lpszName
Name der Menübandkategorie.[in] uiSmallImagesResID
Ressourcen-ID der kleinen Bildliste für die Menübandkategorie.[in] uiLargeImagesResID
Ressourcen-ID der großen Bildliste für die Menübandkategorie.[in] sizeSmallImage
Gibt die Größe von kleinen Bilder für die Menübandkategorie an.[in] sizeLargeImage
Gibt die Größe von großen Bilder für die Menübandkategorie an.[in] nInsertAt
Der nullbasierte Index des Kategorienspeicherorts.[in] pRTI
Zeiger auf eine CMFCRibbonCategory-Klasse Laufzeitklasse, um eine Menübandkategorie zur Laufzeit dynamisch zu erstellen.
Rückgabewert
Ein Zeiger auf die neuen Menübandkategorie, wenn die Methode erfolgreich war; andernfalls NULL.
Hinweise
Wenn der pRTI-Parameter nicht NULL ist, wird der neue Menübandkategorie dynamisch mithilfe der Laufzeitklasse erstellt.
Beispiel
Das folgende Beispiel zeigt, wie die AddCategory-Methode in der Klasse CMFCRibbonBar verwendet.
// Add "Home" category.
// CMFCRibbonBar m_wndRibbonBar
strTemp.LoadString(IDS_RIBBON_HOME);
CMFCRibbonCategory* pCategoryHome = m_wndRibbonBar.AddCategory(strTemp,
IDB_WRITESMALL, IDB_WRITELARGE);
Anforderungen
Header: afxribbonbar.h