Extensibility
13. PresentationML
15.1 Glossary of Shared Terms
15.2.8 Embedded Control Persistence Part
21
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://schemas.openxmlformats.org/officeDocument/2006/relationships/control 22
An instance of this part contains information about an embedded control in the package. This information is 23
provided by the specified control when asked to persist. 24
A package is permitted to contain one or more Embedded Control Persistence parts, and each such part shall 1
be the target of an explicit relationship in an Endnotes (§11.3.4), Footer (§11.3.6), Footnotes (§11.3.7), Header 2
(§11.3.9), or Main Document (§11.3.10) part-relationship item in a WordprocessingML package; a Worksheet 3
part (§12.3.24) 15.2.17in a SpreadsheetML package; or a Handout Master (§13.3.3), Notes Slide (§13.3.5), 4
Notes Master (§13.3.4), Slide (§13.3.8), Slide Layout (§13.3.9), Slide Master (§13.3.10) part-relationship item in 5
a PresentationML package. 6
The content type of this part shall determine the format and contents of the embedded control. 7
[Example: The following example shows the persistence that could be used for an embedded control which is a 8
Java applet within a WordprocessingML document: 9
<w:p> 10
<w:r w:rsidR="005810E1"> 11
<w:object w:dxaOrig="1440" w:dyaOrig="1440"> 12
<v:shapetype id="_x0000_t75" coordsize="21600,21600" o:spt="75" 13
o:preferrelative="t" path="m@4@5l@4@11@9@11@9@5xe" filled="f" stroked="f"> 14
<v:stroke joinstyle="miter" /> 15
<v:formulas> 16
<v:f eqn="if lineDrawn pixelLineWidth 0" /> 17 <v:f eqn="sum @0 1 0" /> 18 <v:f eqn="sum 0 0 @1" /> 19 <v:f eqn="prod @2 1 2" /> 20 <v:f eqn="prod @3 21600 pixelWidth" /> 21 <v:f eqn="prod @3 21600 pixelHeight" /> 22 <v:f eqn="sum @0 0 1" /> 23 <v:f eqn="prod @6 1 2" /> 24 <v:f eqn="prod @7 21600 pixelWidth" /> 25 <v:f eqn="sum @8 21600 0" /> 26 <v:f eqn="prod @7 21600 pixelHeight" /> 27 <v:f eqn="sum @10 21600 0" /> 28 </v:formulas> 29
<v:path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect" /> 30
<o:lock v:ext="edit" aspectratio="t" /> 31
</v:shapetype> 32
<v:shape id="_x0000_i1027" type="#_x0000_t75" 33
style="width:1in;height:24pt" o:ole=""> 34
<v:imagedata r:id="rId4" o:title="" /> 35
</v:shape> 36
<w:control r:id="rId5" w:name="CommandButton1" w:shapeid="_x0000_i1027" 37 /> 38 </w:object> 39 </w:r> 40 </w:p> 41
The relationship type for rId5 is: http://schemas.openxmlformats.org/officeDocument/ 1
2006/relationships/control 2
The XML content of the part referenced by rId5 could be: 3
<applet xlink:href="../../../../Program%20Files/Application" 4
xlink:type="simple" xlink:show="embed" xlink:actuate="onLoad" 5
code="CalculateApplet.class" may-script="false"/> 6
end example]
7
[Example: The following example shows the persistence that could be used for an embedded control which is 8
an ActiveX control within a WordprocessingML document: 9
<w:p> 10
<w:r w:rsidR="005810E1"> 11
<w:object w:dxaOrig="1440" w:dyaOrig="1440"> 12
<v:shapetype id="_x0000_t75" coordsize="21600,21600" o:spt="75" 13
o:preferrelative="t" path="m@4@5l@4@11@9@11@9@5xe" filled="f" stroked="f"> 14
<v:stroke joinstyle="miter" /> 15
<v:formulas> 16
<v:f eqn="if lineDrawn pixelLineWidth 0" /> 17 <v:f eqn="sum @0 1 0" /> 18 <v:f eqn="sum 0 0 @1" /> 19 <v:f eqn="prod @2 1 2" /> 20 <v:f eqn="prod @3 21600 pixelWidth" /> 21 <v:f eqn="prod @3 21600 pixelHeight" /> 22 <v:f eqn="sum @0 0 1" /> 23 <v:f eqn="prod @6 1 2" /> 24 <v:f eqn="prod @7 21600 pixelWidth" /> 25 <v:f eqn="sum @8 21600 0" /> 26 <v:f eqn="prod @7 21600 pixelHeight" /> 27 <v:f eqn="sum @10 21600 0" /> 28 </v:formulas> 29
<v:path o:extrusionok="f" gradientshapeok="t" o:connecttype="rect" /> 30
<o:lock v:ext="edit" aspectratio="t" /> 31
</v:shapetype> 32
<v:shape id="_x0000_i1027" type="#_x0000_t75" 33
style="width:1in;height:24pt" o:ole=""> 34
<v:imagedata r:id="rId4" o:title="" /> 35
</v:shape> 36
<w:control r:id="rId5" w:name="CommandButton1" w:shapeid="_x0000_i1027" 37
/> 38
</w:object> 39
</w:p> 1
The relationship type for rId5 is: http://schemas.openxmlformats.org/officeDocument/ 2
2006/relationships/control 3
The content type of the part referenced by rId5 could be: application/vnd.ms-office.activeX+xml 4
The XML content of the part referenced by rId5 could be: 5 <ax:ocx ax:classid="{D7053240-CE69-11CD-A777-00DD01143C57}" 6 ax:persistence="persistPropertyBag" 7 xmlns:ax="http://schemas.microsoft.com/office/2006/activeX"> 8
<ax:ocxPr ax:name="Caption" ax:value="CommandButton1" /> 9
<ax:ocxPr ax:name="Size" ax:value="2540;847" /> 10
<ax:ocxPr ax:name="FontName" ax:value="Calibri" /> 11
<ax:ocxPr ax:name="FontHeight" ax:value="225" /> 12
<ax:ocxPr ax:name="FontCharSet" ax:value="0" /> 13
<ax:ocxPr ax:name="FontPitchAndFamily" ax:value="2" /> 14
<ax:ocxPr ax:name="ParagraphAlign" ax:value="3" /> 15
</ax:ocx> 16
end example]
17
An Embedded Control Persistence part shall be located within the package containing the source relationship 18
(expressed syntactically, the TargetMode attribute of the Relationship element shall be Internal). 19
An Embedded Control Persistence part shall not have any implicit or explicit relationships to other parts 20
defined by this Standard. 21