CMFCRibbonCategory クラス
更新 : 2007 年 11 月
CMFCRibbonCategory クラスは、リボン パネルのグループを含むリボン タブを実装します。
class CMFCRibbonCategory : public CObject
メンバ
プロテクト コンストラクタ
名前 |
説明 |
|---|---|
コンストラクタです。 |
パブリック メソッド
名前 |
説明 |
|---|---|
非表示の要素をリボン カテゴリに追加します。 |
|
新しいパネルをリボン カテゴリに追加します。 |
|
|
|
|
|
|
|
|
|
リボン カテゴリのコンテキスト ID を返します。 |
|
リボン カテゴリに関連付けられたユーザー定義データを返します。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
リボン カテゴリで使用される大きいイメージの一覧への参照を返します。 |
|
|
|
|
|
指定したインデックス位置にあるリボン パネルへのポインタを返します。 |
|
リボン カテゴリ内のリボン パネルの数を返します。 |
|
|
|
指定されたリボン パネルのインデックスを返します。 |
|
|
|
|
|
|
|
|
|
カテゴリで使用される小さいイメージのリストへの参照を返します。 |
|
リボン カテゴリ タブの現在の色を返します。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
リボン カテゴリが表示の状態にされているかどうかを判定します。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
リボン カテゴリ内のリボン パネルを折りたたむ順序を定義します。 |
|
ユーザー定義データをリボン カテゴリに格納します。 |
|
KeyTip をリボン カテゴリに割り当てます。 |
|
|
|
リボン カテゴリの色を設定します。 |
解説
通常、リボン カテゴリは、新しく作成されたリボン カテゴリへのポインタを返す CMFCRibbonBar::AddCategory を呼び出すことで間接的に作成します。カテゴリにパネルを追加するには、CMFCRibbonCategory::AddPanel を呼び出します。
CMFCRibbonTab クラスはリボン カテゴリを描画します。これは、CMFCRibbonBaseElement クラスから派生します。
リボン カテゴリの作成と、リボン カテゴリへのパネルの追加方法を次の例に示します。
// Create a new ribbon category and get a pointer to it
CMFCRibbonCategory* pCategory = m_wndRibbonBar.AddCategory
(_T("&Write"), // Category name
IDB_WRITE, // Category small images (16 x 16)
IDB_WRITE_LARGE); // Category large images (32 x 32)
// Add a panel to the new category
CMFCRibbonPanel* pPanel = pCategory->AddPanel (
_T("Clipboard"), // Panel name
m_PanelIcons.ExtractIcon (0)); // Panel icon
次の図は、RibbonApp サンプル アプリケーションの Home カテゴリを示します。
.png "CMFCRibbonCategory イメージ")
継承階層
必要条件
ヘッダー : afxribboncategory.h