Share via


2.2.139 CustomTab

Target namespace: http://schemas.microsoft.com/office/taskpaneappversionoverrides

Referenced by: CommandSurfaceExtensionPoint, PrimaryCommandSurface

Specifies an Office Add-in defined tab in the Office client application where this Office Add-in will customize the user interface.

Child Elements:

Group: A Group element that specifies a specific group of user interface extension points in a tab in the Office client application.

OfficeGroup: An OfficeGroup element that specifies a built-in Office group in tabs using published control ID.

Label: A ShortResourceReference element that specifies the label of the custom tab.

InsertBefore: A ShortString element that specifies the published id of a built-in Office tab. The custom tab will be inserted before the specified tab.

InsertAfter: A ShortString element that specifies the published id of an Office tab. The custom tab will be inserted after the specified tab.

Attributes:

id: A ShortString attribute that specifies the identifier of the tab to which the child groups belong. If this tab is a CustomTab element, it is the identifier of the new tab. If it is an OfficeTab, it is the identifier of the preexisting Office UI tab in which to insert content.

The following W3C XML Schema ([XMLSCHEMA1/2] section 2.1) fragment specifies the contents of this complex type.

 <xs:complexType name="CustomTab">
   <xs:complexContent>
     <xs:extension base="Tab">
       <xs:sequence>
         <xs:choice minOccurs="1" maxOccurs="unbounded">
           <xs:element name="Group" type="Group"/>
           <xs:element name="OfficeGroup" type="OfficeGroup"/>
         </xs:choice>
         <xs:element name="Label" type="bt:ShortResourceReference" minOccurs="1" maxOccurs="1"/>
         <xs:choice minOccurs="0" maxOccurs="1">
           <xs:element name="InsertBefore" type="bt:ShortString"/>
           <xs:element name="InsertAfter" type="bt:ShortString"/>
         </xs:choice>
       </xs:sequence>
     </xs:extension>
   </xs:complexContent>
 </xs:complexType>

See section 5.7 for the full W3C XML Schema ([XMLSCHEMA1/2] section 2.1).