CMFCRibbonBar::AddContextCategory
Crea e inicializa una nueva categoría de contexto para la barra de la cinta de opciones.
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
);
Parámetros
[in] lpszName
nombre de la categoría.[in] lpszContextName
Nombre de la leyenda de la categoría de contexto.[in] uiContextID
Identificador del contexto[in] clrContext
Color de la leyenda de la categoría de contexto.[in] uiSmallImagesResID
Id. de recurso de la imagen de una categoría de contexto.[in] uiLargeImagesResID
Id. de recurso de imagen grande de una categoría de contexto.[in] sizeSmallImage
Tamaño de una imagen pequeña.[in] sizeLargeImage
Tamaño de una imagen grande.[in] pRTI
Puntero a una clase en tiempo de ejecución.
Valor devuelto
Un puntero a la categoría recién creada, o NULL si el método de CreateObject de pRTI no puede crear la categoría especificada.
Comentarios
Utilice esta función para agregar una categoría de contexto. Las categorías de contexto son un tipo especial de categoría que puede mostrar u ocultar en tiempo de ejecución, dependiendo del contexto de la aplicación. Por ejemplo, cuando el usuario selecciona un objeto, puede mostrar las fichas especiales con las categorías de contexto que se utiliza para cambiar el objeto seleccionado concreto.
Color de una categoría de contexto puede ser uno de los siguientes valores:
AFX_CategoryColor_None
AFX_CategoryColor_Red
AFX_CategoryColor_Orange
AFX_CategoryColor_Yellow
AFX_CategoryColor_Green
AFX_CategoryColor_Blue
AFX_CategoryColor_Indigo
AFX_CategoryColor_Violet
Requisitos
encabezado: afxribbonbar.h