CMFCRibbonBar::AddContextCategory

创建并初始化功能区栏的新上下文类。

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 
);

参数

  • [in] lpszName
    类别的名称。

  • [in] lpszContextName
    上下文类声明的名称。

  • [in] uiContextID
    上下文ID.

  • [in] clrContext
    上下文类声明的颜色。

  • [in] uiSmallImagesResID
    上下文类的小图像的资源ID。

  • [in] uiLargeImagesResID
    上下文类的大图像的资源ID。

  • [in] sizeSmallImage
    一个小图像的大小。

  • [in] sizeLargeImage
    一个大图像的大小。

  • [in] pRTI
    对运行时选件类的指针。

返回值

为新创建的类的指针或 NULL,如果 pRTICreateObject 方法不能创建指定的类别。

备注

使用此功能添加上下文类。上下文类是可以显示或隐藏在运行时类的一个特定类型,根据当前应用程序上下文。例如,在中,当用户选择某对象时,可以显示与使用更改特定选定对象的上下文类的特定选项。

上下文类的颜色可为下列值之一:

  • AFX_CategoryColor_None

  • AFX_CategoryColor_Red

  • AFX_CategoryColor_Orange

  • AFX_CategoryColor_Yellow

  • AFX_CategoryColor_Green

  • AFX_CategoryColor_Blue

  • AFX_CategoryColor_Indigo

  • AFX_CategoryColor_Violet

要求

标头: afxribbonbar.h

请参见

参考

CMFCRibbonBar选件类

层次结构图