15.2.9 Embedded Control Persistence Part

Content Type:

Any supported control type.

[Note: There are a number of possible control types. One example of a potential control type would be an Active X control, which would use the following content type: application/vnd.ms-office.activeX+xml. end note]

Root Namespace:

not applicable

Source Relationship:

http://purl.oclc.org/ooxml/officeDocument/relationships/control

An instance of this part contains information about an embedded control in the package. This information is provided by the specified control when asked to persist. [Example: An application might utilize the embedded object server technology KParts or Bonobo to store an embedded object using this part. end example]

A package is permitted to contain one or more Embedded Control Persistence parts, and each such part shall be the target of an explicit relationship in an Endnotes (11.3.4), Footer (11.3.6), Footnotes (11.3.7), Header (11.3.9), or Main Document (11.3.10) part-relationship item in a WordprocessingML package; a Worksheet part (12.3.24) in a SpreadsheetML package; or a Handout Master (13.3.3), Notes Slide (13.3.5), Notes Master (13.3.4), Slide (13.3.8), Slide Layout (13.3.9), Slide Master (13.3.10) part-relationship item in a PresentationML package.

The content type of this part shall determine the format and contents of the embedded control.

[Example: The following example shows the persistence that could be used for an embedded control which is a Java applet within a WordprocessingML document (the drawing object which provides a static image representation of the control, used when the Java applet itself is unavailable, has been omitted for brevity):

<w:p>
  <w:r w:rsidR="005810E1">
    <w:object w:dxaOrig="1440"
      <w:drawing>
        …
      </w:drawing>
      <w:control r:id="rId5" w:name="CommandButton1" w:shapeid="1027" />
    </w:object>
  </w:r>
</w:p>

The relationship type for rId5 is: http://purl.oclc.org/ooxml/officeDocument/relationships/control

The XML content of the part referenced by rId5 could be:

<applet xlink:href="../../../../Program%20Files/Application" xlink:type="simple"
xlink:show="embed" xlink:actuate="onLoad" code="CalculateApplet.class" may-
script="false"/>

end example]

[Example: The following example shows the persistence that could be used for an embedded control which is an ActiveX control within a WordprocessingML document(the drawing object which provides a static image representation of the control, used when the ActiveX control itself is unavailable, has been omitted for brevity):

<w:p>
  <w:r w:rsidR="005810E1">
    <w:object w:dxaOrig="1440" w:dyaOrig="1440">
      <w:drawing>
        …
      </w:drawing>
      <w:control r:id="rId5" w:name="CommandButton1" w:shapeid="1027" />
    </w:object>
  </w:r>
</w:p>

The relationship type for rId5 is: http://purl.oclc.org/ooxml/officeDocument/relationships/control

The content type of the part referenced by rId5 could be: application/vnd.ms-office.activeX+xml

The XML content of the part referenced by rId5 could be:

<ax:ocx ax:classid="{D7053240-CE69-11CD-A777-00DD01143C57}"
  ax:persistence="persistPropertyBag"
  xmlns:ax="http://schemas.microsoft.com/office/2006/activeX">
  <ax:ocxPr ax:name="Caption" ax:value="CommandButton1" />
  <ax:ocxPr ax:name="Size" ax:value="2540;847" />
  <ax:ocxPr ax:name="FontName" ax:value="Calibri" />
  <ax:ocxPr ax:name="FontHeight" ax:value="225" />
  <ax:ocxPr ax:name="FontCharSet" ax:value="0" />
  <ax:ocxPr ax:name="FontPitchAndFamily" ax:value="2" />
  <ax:ocxPr ax:name="ParagraphAlign" ax:value="3" />
</ax:ocx>

end example]

An Embedded Control Persistence part shall be located within the package containing the relationships part (expressed syntactically, the TargetMode attribute of the Relationship element shall be Internal).

An Embedded Control Persistence part shall not have any implicit or explicit relationships to other parts defined by ISO/IEC 29500.