2.2.33 ribbon (Ribbon)

This element is used to reference the Ribbon of the application and its contents.

The following table summarizes the elements that are parents of this element.

Parent Elements
customUI (section 2.2.14)

The following table summarizes the child elements of this element.

Child Elements	Section
contextualTabs (List of Contextual Tab Sets)	2.2.10
officeMenu (Office Menu)	2.2.31
qat (Quick Access Toolbar)	2.2.32
tabs (List of Tabs)	2.2.40

The following table summarizes the attributes of this element.

Attributes

Description

startFromScratch (start from scratch)

Specifies that the application's built-in ribbon UI is reduced to a minimal set of features, providing a clean slate on which to build custom UI. If this attribute is omitted, its value SHOULD default to "false". For example, consider the following XML fragment:  <ribbon startFromScratch="true">    …  </ribbon> In this example, the application's ribbon is put into start from scratch mode. The possible values for this attribute are defined by the XML schema boolean datatype.

The following XML schema fragment defines the contents of this element:

 <xsd:complexType name="CT_Ribbon">
    <xsd:all>
    <xsd:element name="officeMenu" type="CT_OfficeMenu" minOccurs="0" maxOccurs="1"/>
    <xsd:element name="qat" type="CT_Qat" minOccurs="0" maxOccurs="1">
    <xsd:unique name="qatControls">
    <xsd:selector xpath="*/*"/>
    <xsd:field xpath="@id"/>
    </xsd:unique>
    </xsd:element>
    <xsd:element name="tabs" type="CT_Tabs" minOccurs="0" maxOccurs="1"/>
    <xsd:element name="contextualTabs" type="CT_ContextualTabs" minOccurs="0" maxOccurs="1"/>
    </xsd:all>
    <xsd:attribute name="startFromScratch" type="xsd:boolean" use="optional"/>
 </xsd:complexType>