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

  • Article

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.

Note

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

Applies to: The information in this topic applies to document-level projects and application-level projects for the following applications: Excel 2013 and Excel 2010; InfoPath 2013 and InfoPath 2010; Outlook 2013 and Outlook 2010; PowerPoint 2013 and PowerPoint 2010; Project 2013 and Project 2010; Visio 2013 and Visio 2010; Word 2013 and Word 2010. For more information, see Features Available by Office Application and Project Type.

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 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 MyRibbon.

    Protected Overrides Function CreateRibbonExtensibilityObject() As  _
Microsoft.Office.Core.IRibbonExtensibility
    Return New MyRibbon()
End Function

    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.

See Also

Tasks

Walkthrough: Creating a Custom Tab by Using the Ribbon Designer

Walkthrough: Creating a Custom Tab by Using Ribbon XML

Concepts

Ribbon Designer

Ribbon XML

Other Resources

Ribbon Overview