CMFCRibbonBar::AddCategory
Crea e inicializa una nueva categoría de la cinta de opciones para la barra de la cinta de opciones.
CMFCRibbonCategory* AddCategory(
LPCTSTR lpszName,
UINT uiSmallImagesResID,
UINT uiLargeImagesResID,
CSize sizeSmallImage = CSize(16, 16),
CSize sizeLargeImage = CSize(32, 32),
int nInsertAt = -1,
CRuntimeClass* pRTI = NULL
);
Parámetros
[in] lpszName
Nombre de la categoría de la cinta de opciones.[in] uiSmallImagesResID
Id. de recurso de la imagen que aparece para la categoría de la cinta de opciones.[in] uiLargeImagesResID
Id. de recurso de imagen grande incluida para la categoría de la cinta de opciones.[in] sizeSmallImage
Especifica el tamaño de las pequeñas imágenes para la categoría de la cinta de opciones.[in] sizeLargeImage
Especifica el tamaño de las imágenes grandes para la categoría de la cinta de opciones.[in] nInsertAt
Índice de base cero de la ubicación de la categoría.[in] pRTI
Puntero a una clase en tiempo de ejecución de CMFCRibbonCategory Class para crear dinámicamente una categoría de la cinta de opciones en tiempo de ejecución.
Valor devuelto
Un puntero a la nueva categoría de la cinta de opciones si el método fue correcto; si no, NULL.
Comentarios
Si el parámetro de pRTI no es NULL, la nueva categoría de la cinta de opciones se crea dinámicamente mediante la clase en tiempo de ejecución.
Ejemplo
El ejemplo siguiente muestra cómo utilizar el método de AddCategory en la clase de CMFCRibbonBar .
// Add "Home" category.
// CMFCRibbonBar m_wndRibbonBar
strTemp.LoadString(IDS_RIBBON_HOME);
CMFCRibbonCategory* pCategoryHome = m_wndRibbonBar.AddCategory(strTemp,
IDB_WRITESMALL, IDB_WRITELARGE);
Requisitos
encabezado: afxribbonbar.h