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
);
パラメーター
[入力] lpszName
リボン カテゴリの名前。[入力] uiSmallImagesResID
リボン カテゴリの小さいイメージ リストのリソース ID。[入力] uiLargeImagesResID
リボン カテゴリの大きいイメージ リストのリソース ID。[入力] sizeSmallImage
リボン カテゴリの小さいイメージのサイズを指定します。[入力] sizeLargeImage
リボン カテゴリの大きいイメージのサイズを指定します。[入力] nInsertAt
カテゴリの位置を示す 0 から始まるインデックス。[入力] 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