CMFCRibbonBar::AddCategory

创建并初始化功能区栏的新功能区类别。

CMFCRibbonCategory* AddCategory(
   LPCTSTR lpszName,
   UINT uiSmallImagesResID,
   UINT uiLargeImagesResID,
   CSize sizeSmallImage = CSize(16, 16),
   CSize sizeLargeImage = CSize(32, 32),
   int nInsertAt = -1,
   CRuntimeClass* pRTI = NULL 
);

参数

  • [in] lpszName
    功能区类的名称。

  • [in] uiSmallImagesResID
    小图像的资源ID为功能区类别的列表。

  • [in] uiLargeImagesResID
    大图像的资源ID为功能区类别的列表。

  • [in] sizeSmallImage
    为功能区类别指定小图像的大小。

  • [in] sizeLargeImage
    为功能区类别指定大图像的大小。

  • [in] nInsertAt
    从零开始类别位置的索引。

  • [in] pRTI
    对动态创建功能区类的 CMFCRibbonCategory选件类 运行时选件类的指针在运行时。

返回值

到新的功能区类的指针,如果方法成功;否则,NULL。

备注

如果 pRTI 参数不是 NULL,使用运行时选件类,新的功能区类别动态创建。

示例

下面的示例在 CMFCRibbonBar 选件类演示如何使用 AddCategory 方法。

    // Add "Home" category.
    // CMFCRibbonBar m_wndRibbonBar
    strTemp.LoadString(IDS_RIBBON_HOME);
    CMFCRibbonCategory* pCategoryHome = m_wndRibbonBar.AddCategory(strTemp, 
        IDB_WRITESMALL, IDB_WRITELARGE);

要求

标头: afxribbonbar.h

请参见

参考

CMFCRibbonBar选件类

层次结构图