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

NameDescription
CMFCRibbonCustomizeDialog::CMFCRibbonCustomizeDialogConstructs a CMFCRibbonCustomizeDialog object.
CMFCRibbonCustomizeDialog::~CMFCRibbonCustomizeDialogDestructor.

Public Methods

NameDescription
CMFCRibbonCustomizeDialog::GetThisClassUsed 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.

CObject

CCmdTarget

CWnd

CPropertySheet

CMFCPropertySheet

CMFCRibbonCustomizeDialog

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.

Hierarchy Chart
Classes

Show: