共用方式為


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 類別

階層架構圖表