リボン ベースのアプリケーションの Customize ダイアログ ボックスのカスタム ページを実装します。
構文
class CMFCRibbonCustomizePropertyPage: public CMFCPropertyPage
メンバー
パブリック コンストラクター
| 名前 | 説明 |
|---|---|
| CMFCRibbonCustomizePropertyPage::CMFCRibbonCustomizePropertyPage | CMFCRibbonCustomizePropertyPage オブジェクトを構築します。 |
CMFCRibbonCustomizePropertyPage::~CMFCRibbonCustomizePropertyPage |
デストラクターです。 |
パブリック メソッド
| 名前 | 説明 |
|---|---|
| CMFCRibbonCustomizePropertyPage::AddCustomCategory | Commands コンボ ボックスにカスタム カテゴリを追加します。 |
CMFCRibbonCustomizePropertyPage::CreateObject |
このクラス型の動的インスタンスを作成するために、フレームワークで使用されます。 |
CMFCRibbonCustomizePropertyPage::GetThisClass |
このクラス型に関連付けられている CRuntimeClass オブジェクトへのポインターを取得するためにフレームワークによって使用されます。 |
| CMFCRibbonCustomizePropertyPage::OnOK | ユーザーが Customize ダイアログ ボックスで OK をクリックしたときにシステムによって呼び出されます。 |
解説
Customize ダイアログ ボックスにカスタム コマンドを追加する場合は、AFX_WM_ON_RIBBON_CUSTOMIZE メッセージを処理する必要があります。 メッセージ ハンドラーで、スタック上の CMFCRibbonCustomizePropertyPage オブジェクトをインスタンス化します。 カスタム コマンドの一覧を作成し、 AddCustomCategory を呼び出して新しいページを Customize ダイアログ ボックスに追加します。
例
次の例では、 CMFCRibbonCustomizePropertyPage オブジェクトを作成し、カスタム カテゴリを追加する方法を示します。
// Create "Customize" page
// CMFCRibbonBar m_wndRibbonBar
CMFCRibbonCustomizePropertyPage pageCustomize(&m_wndRibbonBar);
// Create a list of popular items:
CList<UINT, UINT> lstPopular;
lstPopular.AddTail(ID_FILE_NEW);
lstPopular.AddTail(ID_FILE_OPEN);
// add a custom category
pageCustomize.AddCustomCategory(_T("Popular Commands"), lstPopular);
継承階層
CMFCRibbonCustomizePropertyPage
要件
Header: afxribboncustomizedialog.h
CMFCRibbonCustomizePropertyPage::AddCustomCategory
Commands コンボ ボックスにカスタム カテゴリを追加します。
void AddCustomCategory(
LPCTSTR lpszName,
const CList<UINT, UINT>& lstIDS);
パラメーター
lpszName
[in]カスタム カテゴリ名を指定します。
lstIDS
[in]カスタム カテゴリに表示されるリボン コマンド ID が含まれています。
解説
このメソッドは、 lpszName という名前のカテゴリを Commands コンボ ボックスに追加します。 ユーザーがカテゴリを選択すると、 lstIDS で指定されたコマンドがコマンド 一覧に表示されます。
CMFCRibbonCustomizePropertyPage::CMFCRibbonCustomizePropertyPage
CMFCRibbonCustomizePropertyPage オブジェクトを構築します。
CMFCRibbonCustomizePropertyPage(CMFCRibbonBar* pRibbonBar = NULL);
パラメーター
pRibbonBar
[in]カスタマイズするオプションの対象となるリボン コントロールへのポインター。
CMFCRibbonCustomizePropertyPage::OnOK
ユーザーが [Customize] ダイアログ ボックスで OK をクリックすると、システムによって呼び出されます。
virtual void OnOK();
解説
既定の実装では、[ Customize ] ダイアログ ボックスで選択したオプションがクイック アクセス ツール バーに適用されます。