3.4.1.3 CustomUI Part

  • Article

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

An instance of this part type contains information about the Ribbon customizations ([MS-CUSTOMUI]) specific to this package.

[Example: A SpreadsheetML document that represents a timecard could contain custom UI controls to guide the user in filling out the timecard. end example]

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

[Example: The following package part-relationship item contains a relationship to a CustomUI 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>

end example]

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

[Example: The following CustomUI content markup would specify that the ribbon tab with ID TabHome should 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>

end example]

A CustomUI part shall be located within the package containing the source relationship (expressed syntactically, the TargetMode attribute of the Relationship element shall be Internal).

A CustomUI part is permitted to have explicit relationships to the following parts defined by Office Open XML File Formats: