CMFCRibbonBar::AddContextCategory
Erstellt und initialisiert eine neue Kontextkategorie für die Menübandleiste.
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
);
Parameter
[in] lpszName
Name der Kategorie.[in] lpszContextName
Name der Kontextkategorienbeschriftung.[in] uiContextID
Kontext ID[in] clrContext
Farbe der Kontextkategorienbeschriftung.[in] uiSmallImagesResID
Ressourcen-ID des kleinen Bilds einer Kontextkategorie.[in] uiLargeImagesResID
Ressourcen-ID des großen Bildern einer Kontextkategorie.[in] sizeSmallImage
Größe eines kleinen Bilder.[in] sizeLargeImage
Größe eines großen Bildern.[in] pRTI
Zeiger auf einer Laufzeitklasse.
Rückgabewert
Ein Zeiger auf die neu erstellten Kategorie oder NULL, wenn die CreateObject-Methode von pRTI die angegebene Kategorie nicht erstellen kann.
Hinweise
Verwenden Sie diese Funktion, um eine Kontextkategorie hinzuzufügen.Kontextkategorien sind ein besonderer Typ Kategorie, der zur Laufzeit angezeigt oder ausgeblendet werden kann, abhängig von dem aktuellen Anwendungskontext.Wenn der Benutzer ein Objekt abruft, können Sie spezielle Registerkarten mit Kontextkategorien anzeigen, die Sie verwenden, um die spezifischen ausgewählte Objekt zu ändern.
Die Farbe einer Kontextkategorie kann einer der folgenden Werte sein:
AFX_CategoryColor_None
AFX_CategoryColor_Red
AFX_CategoryColor_Orange
AFX_CategoryColor_Yellow
AFX_CategoryColor_Green
AFX_CategoryColor_Blue
AFX_CategoryColor_Indigo
AFX_CategoryColor_Violet
Anforderungen
Header: afxribbonbar.h