CMFCRibbonCustomizeDialog Class
The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.
The latest version of this topic can be found at CMFCRibbonCustomizeDialog Class.
Displays the ribbon Customize page.
class CMFCRibbonCustomizeDialog : public CMFCPropertySheet
Public Constructors
| Name | Description |
|---|---|
| CMFCRibbonCustomizeDialog::CMFCRibbonCustomizeDialog | Constructs a CMFCRibbonCustomizeDialog object. |
CMFCRibbonCustomizeDialog::~CMFCRibbonCustomizeDialog | Destructor. |
Public Methods
| Name | Description |
|---|---|
CMFCRibbonCustomizeDialog::GetThisClass | Used by the framework to obtain a pointer to the CRuntimeClass object that is associated with this class type. |
MFC instantiates this class automatically if you do not process the AFX_WM_ON_RIBBON_CUSTOMIZE message, or if you return 0 from the message handler.
If you want to use this class in your application to display the ribbon Customize dialog box, just instantiate it and call the DoModal method.
Because this class is derived from CMFCPropertySheet Class, you can add custom pages by using the CMFCPropertySheet API.
Header: afxribboncustomizedialog.h
Constructs a CMFCRibbonCustomizeDialog object.
CMFCRibbonCustomizeDialog(
CWnd* pWndParent,
CMFCRibbonBar* pRibbon);
Parameters
[in] pWndParent
A pointer to the parent window (usually the main frame).
[in] pRibbon
A pointer to the CMFCRibbonBar that is to be customized.
Example
The following example demonstrates how to construct a CMFCRibbonCustomizeDialog object.
// CMFCRibbonBar m_wndRibbonBar // this points to CMainFrame CMFCRibbonCustomizeDialog* cDialog = new CMFCRibbonCustomizeDialog(this, &m_wndRibbonBar);
Remarks
The constructor instantiates a CMFCRibbonCustomizePropertyPage Class object and adds it to the collection of property sheet pages.