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
);
パラメーター
[入力] lpszName
カテゴリの名前。[入力] lpszContextName
コンテキスト カテゴリ キャプションの名前。[入力] uiContextID
コンテキスト ID。[入力] clrContext
コンテキスト カテゴリ キャプションの色。[入力] uiSmallImagesResID
コンテキスト カテゴリの小さいイメージのリソース ID。[入力] uiLargeImagesResID
コンテキスト カテゴリの大きいイメージのリソース ID。[入力] sizeSmallImage
小さいイメージのサイズ。[入力] sizeLargeImage
大きいイメージのサイズ。[入力] pRTI
ランタイム クラスへのポインター。
戻り値
新しく作成されたカテゴリへのポインター。pRTI の CreateObject メソッドが指定されたカテゴリを作成できない場合は NULL。
解説
コンテキスト カテゴリを追加します。コンテキスト カテゴリは、現在のアプリケーション コンテキストに応じて、実行時に表示または非表示にできる特別な種類のカテゴリです。たとえば、ユーザーがオブジェクトを選択したときに、選択した特定のオブジェクトの変更に使用するコンテキスト カテゴリを持つ特別なタブを表示できます。
コンテキスト カテゴリの色は、次のいずれかの値を設定できます。
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