The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

How to: Export a Ribbon from the Ribbon Designer to Ribbon XML

Applies to

The information in this topic applies only to the specified Visual Studio Tools for Office projects and versions of Microsoft Office.

Project type

  • Document-level projects

  • Application-level projects

Microsoft Office version

  • Excel 2007

  • Word 2007

  • Outlook 2007

  • PowerPoint 2007

For more information, see Features Available by Application and Project Type.

The Ribbon (Visual Designer) item does not support all possible types of Ribbon customization. To customize the Ribbon in advanced ways, you can export the Ribbon from the designer to Ribbon XML and edit the XML directly.


Not all property values appear in the Ribbon XML file. For more information, see Ribbon Overview.

To export a Ribbon from the Ribbon Designer to Ribbon XML

  1. Right-click the Ribbon code file in Solution Explorer, and then click View Designer.

  2. Right-click the Ribbon Designer, and then click Export Ribbon to XML.

    Visual Studio Tools for Office adds a Ribbon XML file and a Ribbon XML code file to your project.

  3. In the Ribbon code class, locate the comments that start with TODO:.

  4. Copy the code block in these comments to the ThisAddin, ThisWorkbook, or ThisDocument class, depending on which type of solution you are developing.

    This code enables the Microsoft Office application to discover and load your custom Ribbon. For more information, see Ribbon XML.

  5. In the ThisAddin, ThisWorkbook, or ThisDocument class, uncomment the code block.

    After you uncomment the code, it should resemble the following example. In this example, the Ribbon class is called Ribbon1.

    protected override Microsoft.Office.Core.IRibbonExtensibility CreateRibbonExtensibilityObject()
        return new MyRibbon();
  6. Switch to the Ribbon XML code file and find the Ribbon Callbacks region.

    This is where you write callback methods to handle user actions, such as clicking a button.

  7. Create a callback method for each event handler that you wrote in the Ribbon Designer code.

  8. Move all your event handler code from the event handlers to the callback methods, and modify the code to work with the Ribbon extensibility (RibbonX) programming model.

    For information about writing callback methods and using the RibbonX programming model, see Ribbon XML.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2014 Microsoft