Share via


2.2.176 ShowTaskpane

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

Specifies a taskpane extension URL to display when a user interface extension point is invoked by the user.

Child Elements:

TaskpaneId: A ShortString element that specifies the ID of the taskpane container. Specifying the same ID multiple times allows it to reuse the same taskpane container.

A TaskpaneId with a value of Office.AutoShowTaskpaneWithDocument specifies a ShowTaskpane action that SHOULD be displayed by the host when a file is opened that contains a CT_OsfWebExtension, as defined in [MS-OWEXML] section 2.2.7, that references this add-in in the Reference element and contains a CT_OsfWebExtensionProperty ([MS-OWEXML] section 2.2.1) in its Properties element that has a name attribute with the value "Office.AutoShowTaskpaneWithDocument" and a value attribute with the value "true". If the Office.AutoShowTaskpaneWithDocument is specified as the TaskpaneId for multiple ShowTaskPane actions, the first ShowTaskpane action in the FormFactor of the host SHOULD be used for the document open action.

SourceLocation: A URLResourceReference element that specifies the page to load on the taskpane.

Title: A ShortResourceReference element that specifies the title of the taskpane container.

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

 <xs:complexType name="ShowTaskpane">
   <xs:complexContent>
     <xs:extension base="Action">
       <xs:sequence>
         <xs:element name="TaskpaneId" type="bt:ShortString" minOccurs="0" maxOccurs="1"/>
         <xs:element name="SourceLocation" type="bt:URLResourceReference" minOccurs="1" maxOccurs="1"/>
         <xs:element name="Title" type="bt:ShortResourceReference" minOccurs="0" maxOccurs="1"/>
       </xs:sequence>
     </xs:extension>
   </xs:complexContent>
 </xs:complexType>

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