CMFCRibbonPanel クラス
一連のリボン要素を含むパネルを実装します。 このパネルが描画されると、そのパネルに指定されたサイズに対して可能な限り多くの要素が表示されます。
class CMFCRibbonPanel : public CObject
メンバー
プロテクト コンストラクター
[名前] |
説明 |
|---|---|
CMFCRibbonPanel オブジェクトを構築し、初期化します。 |
パブリック メソッド
[名前] |
説明 |
|---|---|
リボン要素をパネルに追加します。 |
|
リボン パネルに区分線を追加します。 |
|
ツール バーをリボン パネルに追加します。 |
|
|
|
指定したコマンド ID により識別される要素を返します。 |
|
|
|
リボン パネル内の要素数を返します。 |
|
パネルに関連付けられているユーザー定義データを返します。 |
|
|
|
|
|
指定されたインデックス位置にあるリボン要素を返します。 |
|
リボン パネルに含まれるすべての要素を取得します。 |
|
|
|
フォーカスのある要素を返します。 |
|
ギャラリー要素の外接する四角形を返します。 |
|
|
|
|
|
|
|
|
|
|
|
リボン パネルの親カテゴリを返します。 |
|
|
|
|
|
|
|
|
|
可視要素の配列を取得します。 |
|
|
|
|
|
|
|
指定した位置にリボン要素を挿入します。 |
|
指定した位置に区分線を挿入します。 |
|
すべてのパネル要素を垂直方向に列単位で中央揃えするかどうかを指定します。 |
|
|
|
|
|
すべてのパネルの列が同じ幅であるかどうかを示します。 |
|
|
|
|
|
指定したリボン要素が表示されるようにギャラリーをスクロールします。 |
|
|
|
|
|
指定したインデックス位置の要素を必要に応じて削除します。 |
|
リボン パネルからすべての要素を削除します。 |
|
要素の対応するインデックス値に基づいて、要素を別の要素と置き換えます。 |
|
指定したコマンド ID に基づいて、要素を別の要素に置き換えます。 |
|
要素を垂直方向に列単位で配置するようにパネルに指示します。 |
|
ユーザー定義データをリボン パネルに関連付けます。 |
|
指定されたコマンド ID を持つ要素にポップアップ メニューを関連付けます。 |
|
指定したランタイム クラス情報で指定されたリボン要素をリボン パネルに追加します。 |
|
指定したランタイム クラス情報で指定されたリボン要素をリボン パネルに追加します。 |
|
指定したリボン要素にフォーカスを設定します。 |
|
列の位置合わせを有効または無効にします。 |
|
リボン パネルを表示するキーボード ショートカットを設定します。 |
|
|
解説
リボン パネルは、リボン カテゴリ内で作成した関連タスクの論理グループです。 リボンのサイズが変化すると、できるだけ多くの要素が表示されるようにパネル レイアウトが自動的に調整されます。
CMFCRibbonCategory::GetPanel メソッドを呼び出すことにより、リボン カテゴリに含まれているリボン パネルを取得できます。
使用例
CMFCRibbonPanel クラスのさまざまなメソッドを使用して CMFCRibbonPanel オブジェクトを構成する方法を次の例に示します。 例では、リボン パネルを表示するショートカット キーを設定する方法、列ごとにパネルに対して要素を垂直に配置する方法、および列の調整を有効にする方法を示しています。 このコード スニペットは、「MSOffice2007Demo サンプル:MFC の Office アプリケーション」の一部です。
// CMFCRibbonCategory* pCategory
// CMFCToolBarImages m_PanelImages
CMFCRibbonPanel* pPanelClipboard = pCategory->AddPanel(_T("Clipboard"), m_PanelImages.ExtractIcon(1));
pPanelClipboard->SetKeys(_T("zc"));
pPanelClipboard->SetCenterColumnVert();
pPanelClipboard->SetJustifyColumns();
継承階層
必要条件
**ヘッダー:**afxRibbonPanel.h