Table of contents
Collapse the table of content
Expand the table of content

IRibbonExtensibility.GetCustomUI Method (Office)

office 365 dev account|Last Updated: 6/12/2017
1 Contributor

Loads the XML markup, either from an XML customization file or from XML markup embedded in the procedure, that customizes the Ribbon user interface.


expression. GetCustomUI( RibbonID )

expression An expression that returns a IRibbonExtensibility object.


NameRequired/OptionalData TypeDescription
RibbonIDRequiredStringThe ID for the RibbonX UI.

Return Value



For Word, Excel, PowerPoint, and Access, there is only one ID for each application. Outlook uses ribbon extensibility to customize not only the ribbon in an inspector, but also the ribbon in an explorer, in various context menus, in contextual tabs in a ribbon, and in the Microsoft Office Backstage view. In each of these scenarios, the developer specifies the custom UI in an XML file that is loaded when Office calls GetCustomUI with a specific ribbon ID.


In the following example, written in C#, the IRibbonExtensibility interface is specified in the class definition. The example then implements the interfaces's only method, GetCustomUI. The method creates an instance of a SteamReader object that reads in the customization markup in an external XML file.

public class Connect : Object, Extensibility.IDTExtensibility2, IRibbonExtensibility 
public string GetCustomUI(string RibbonID) 
 StreamReader customUIReader = new System.IO.StreamReader("C:\\RibbonXSampleCS\\customUI.xml"); 
 string customUIData = customUIReader.ReadToEnd(); 
 return customUIData; 

See also


IRibbonExtensibility Object

Other resources

IRibbonExtensibility Object Members

© 2018 Microsoft