3.6.1.2 ocx (ActiveX Control Data)
This element specifies various information of an ActiveX control embedded in a document.
[Note: This element does not contain placement or application extended properties. The properties stored in this element are those that the ActiveX control can use regardless of container. end note]
[Example: Consider an ActiveX control embedded in a WordprocessingML. Various pieces of information about that control will be specified using the following WordprocessingML:
<ax:ocx ax:classid="{FDD0D569-5B7A-4E3D-820C-5C487DB7796C}" ax:persistence="persistPropertyBag" …>
<ax:ocxPr ax:name="_Version" ax:value="65536"/>
<ax:ocxPr ax:name="_ExtentX" ax:value="2646"/>
<ax:ocxPr ax:name="_ExtentY" ax:value="1323"/>
<ax:ocxPr ax:name="_StockProps" ax:value="0"/>
…
</ax:ocx>
Here, the classid attribute holds the class ID of the ActiveX control, {FDD0D569-5B7A-4E3D-820C-5C487DB7796C}. In this example, the persistence attribute indicates the persistPropertyBag method for persisting various properties of the control. The property bag is stored as a collection of child ocxPr elements. Each ocxPr element contains a single property. end example]
|
Child Elements |
Subclause |
|---|---|
|
ocxPr (Object Property) |
|
Attributes |
Description |
|---|---|
|
classid (ActiveX Control CLSID) |
Specifies the GUID of the ClassID of the ActiveX control.
The possible values for this attribute are defined by the ST_String simple type (§3.6.2.2, ST_String). |
|
license (ActiveX Control License) |
Specifies the license string for the ActiveX control. This string is retrieved from the IClassFactory2 interface of the control.
The possible values for this attribute are defined by the ST_String simple type (§3.6.2.2, ST_String). |
|
persistence (ActiveX Control Property Persistence Style) |
Specifies the explicit method used to persist the properties of the ActiveX control.
The possible values for this attribute are defined by the ST_Persistence simple type (§3.6.2.1, ST_Persistence). |
|
id (ActiveX Control Binary Data)
Namespace: .../officeDocument/2006/relationships |
Specifies the relationship ID, the target of which points to the internal location where the binary data part representing various properties of the ActiveX control is persisted using the persistStorage, persistStream, or persistStreamInit method, as indicated by the persistence attribute of the parent ocx element.
The specified relationship shall be of type http://schemas.microsoft.com/office/2006/relationships/activeXControlBinary.
[Note: The use of this attribute is mutually exclusive with the use of ocxPr child elements. end note]
The possible values for this attribute are defined by the ST_RelationshipId simple type ("[ISO/IEC-29500-1] §22.8.2.1"). |
The following XML Schema fragment defines the contents of this element:
-
<complexType name="CT_Ocx"> <sequence> <element name="ocxPr" type="CT_OcxPr" minOccurs="0" maxOccurs="unbounded"/> </sequence> <attribute name="classid" type="ST_String" use="required"/> <attribute name="license" type="ST_String"/> <attribute ref="r:id" use="optional"/> <attribute name="persistence" use="required" type="ST_Persistence"/> </complexType>