2.1.2 Ribbon Extensibility Part

Content Type:	application/xml
Root Namespace:	http://schemas.microsoft.com/office/2006/01/customui
Source Relationship:	http://schemas.microsoft.com/office/2006/relationships/ui/extensibility

The syntax of the structures contained in this part uses XML schema definition (XSD), as specified in [XMLSCHEMA1] and [XMLSCHEMA2].

This specification defines and references various XML namespaces by using the mechanisms specified in [XMLNS].

An instance of this part type contains information about the ribbon customizations specific to the containing package.

For example, a SpreadsheetML document that represents a timecard could contain custom UI controls to guide the user in filling out the timecard.

A package is permitted to contain at most one Ribbon Extensibility part, and that part is the target of a relationship in the package-relationship item for the document.

For example, the following package part-relationship item contains a relationship to a Ribbon Extensibility part, which is stored in the ZIP item /customUI/customUI.xml:

 <Relationships xmlns="…">
 <Relationship Id="rId5"  
 Type="http://…/2006/relationships/ui/extensibility"
 Target="/customUI/customUI.xml" />
 </Relationships>

The root element for a part of this content type is customUI.

For example, the following Ribbon Extensibility content markup specifies that the ribbon tab with identifier "TabHome" is to be hidden for the containing package:

 <customUI xmlns="http://schemas.microsoft.com/office/2006/01/customui">
 <ribbon>
 <tabs>
 <tab idMso="TabHome" visible="false" />
 </tabs>
 </ribbon>
 </customUI>

A Ribbon Extensibility part is located within the package containing the source relationship. Expressed syntactically, the TargetMode attribute of the Relationship element is "Internal".

A Ribbon Extensibility part is permitted to have explicit relationships to the following parts defined by ECMA-376 Office Open XML File Formats, as specified in [ECMA-376]:

• Image Part, as specified in [ECMA-376] Part 1 section15.2.13.