CMFCRibbonCategory クラス
CMFCRibbonCategory クラスは、リボン パネルのグループを含むリボン タブを実装します。
class CMFCRibbonCategory : public CObject
メンバー
プロテクト コンストラクター
[名前] |
説明 |
|---|---|
コンストラクターです。 |
パブリック メソッド
[名前] |
説明 |
|---|---|
非表示の要素をリボン カテゴリに追加します。 |
|
新しいパネルをリボン カテゴリに追加します。 |
|
|
|
|
|
|
|
|
|
リボン カテゴリのコンテキスト ID を返します。 |
|
リボン カテゴリに関連付けられたユーザー定義データを返します。 |
|
|
|
|
|
|
|
リボン カテゴリに属している最初の可視要素を取得します。 |
|
フォーカスのある要素を返します。 |
|
強調表示されている要素を返します。 |
|
|
|
|
|
|
|
リボン カテゴリに属している最後の可視要素を取得します。 |
|
リボン カテゴリで使用される大きいイメージの一覧への参照を返します。 |
|
|
|
|
|
指定したインデックス位置にあるリボン パネルへのポインターを返します。 |
|
リボン カテゴリ内のリボン パネルの数を返します。 |
|
|
|
指定されたリボン パネルのインデックスを返します。 |
|
|
|
|
|
|
|
|
|
カテゴリで使用される小さいイメージのリストへの参照を返します。 |
|
リボン カテゴリ タブの現在の色を返します。 |
|
|
|
|
|
リボン カテゴリに属しているすべての可視要素を取得します。 |
|
|
|
|
|
|
|
|
|
|
|
リボン カテゴリが表示の状態にされているかどうかを判定します。 |
|
親リボンの外観が Windows 7 スタイル (アプリケーション ボタンが小さい四角形) であるかどうかを示します。 |
|
|
|
|
|
|
|
|
|
|
|
ユーザーがキーボード ボタンを押したときに、フレームワークによって呼び出されます。 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
リボン カテゴリ内のリボン パネルを折りたたむ順序を定義します。 |
|
ユーザー定義データをリボン カテゴリに格納します。 |
|
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