次の方法で共有


CMFCRibbonBar::AddContextCategory

更新 : 2007 年 11 月

コンテキスト カテゴリを追加します。

CMFCRibbonCategory* AddContextCategory(
   LPCTSTR lpszName,
   LPCTSTR lpszContextName,
   UINT uiContextID,
      AFX_RibbonCategoryColor clrContext,
   UINT uiSmallImagesResID,
   UINT uiLargeImagesResID,
   CSize sizeSmallImage=CSize(16,
   16) 1,
   CSize sizeLargeImage=CSize(32,
   32) 3,
   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

参照

概念

MFC 階層図

参照

CMFCRibbonBar クラス