[Table of Contents] [docx version]
VML Reference Material - VML
OLEObject (Embedded OLE Object)
This element specifies an OLE object.
[Example: The following demonstrates a video file embedded in a WordprocessingML document:
<w:object ... >
<v:shape id="_x0000_i1025" type="#_x0000_t75"
style="width:1in;height:24pt" o:ole="">
<v:imagedata r:id="rId4" o:title=""/>
</v:shape>
<o:OLEObject Type="Embed" ProgID="AVIFile" ShapeID="_x0000_i1025"
DrawAspect="Content" ObjectID="_1219561732" r:id="rId5"/>
</w:object>
end example]
Parent Elements |
background (§2.2.1); hdrShapeDefaults (§2.15.1.50); object (§2.3.3.19); pict (§2.3.3.21); pict (§2.9.23); shapeDefaults (§2.15.1.79) |
Child Elements |
Subclause |
FieldCodes (WordprocessingML Field Switches) |
§6.2.2.11 |
LinkType (Embedded Object Alternate Image Request) |
§6.2.2.16 |
LockedField (Embedded Object Cannot Be Refreshed) |
§6.2.2.18 |
Attributes |
Description |
DrawAspect (OLE Object Representation) |
Specifies how the object is represented visually in the application.
[Example:
<o:OLEObject ... DrawAspect="Content"> </o:OLEObject>
end example]
The possible values for this attribute are defined by the ST_OLEDrawAspect simple type (§6.2.3.16). |
id (Relationship)
Namespace: .../officeDocument/2006/relationships |
Specifies the actual OLE object using a standard part relationship lookup.
[Example:
<o:OLEObject ... r:id="rId5"> </o:OLEObject>
end example]
The possible values for this attribute are defined by the ST_RelationshipId simple type (§7.8.2.1). |
ObjectID (OLE Object Unique ID) |
Specifies a unique ID identifying the OLE object.
[Example:
<o:OLEObject ... ObjectID="_1219561732"> </o:OLEObject>
end example]
The possible values for this attribute are defined by the XML Schema string datatype. |
ProgID (OLE Object Application) |
Specifies the OLE server application associated with the OLE object.
[Example:
<o:OLEObject ... ProgID="AVIFile"> </o:OLEObject>
end example]
The possible values for this attribute are defined by the XML Schema string datatype. |
ShapeID (OLE Object Shape) |
Specifies the shape with which the OLE object is associated. A VML shape provides the visual placeholder for an OLE object and this attribute is set to the id of the placeholder shape.
[Example:
<o:OLEObject ... ShapeID="_x0000_i1025"> </o:OLEObject>
end example]
The possible values for this attribute are defined by the XML Schema string datatype. |
Type (OLE Object Type) |
Specifies the type of the OLE connection.
[Example:
<o:OLEObject ... Type="Embed"> </o:OLEObject>
end example]
The possible values for this attribute are defined by the ST_OLEType simple type (§6.2.3.18). |
UpdateMode (OLE Update Mode) |
Specifies how the object is updated with new data if the Type is Link - automatically or on-demand by the user.
[Example:
<o:OLEObject ... UpdateMode="Always"> </o:OLEObject>
end example]
The possible values for this attribute are defined by the ST_OLEUpdateMode simple type (§6.2.3.19). |
The following XML Schema fragment defines the contents of this element:
<complexType name="CT_OLEObject">
<sequence>
<element name="LinkType" type="ST_OLELinkType" minOccurs="0"/>
<element name="LockedField" type="ST_TrueFalseBlank" minOccurs="0"/>
<element name="FieldCodes" type="xsd:string" minOccurs="0"/>
</sequence>
<attribute name="Type" type="ST_OLEType" use="optional"/>
<attribute name="ProgID" type="xsd:string" use="optional"/>
<attribute name="ShapeID" type="xsd:string" use="optional"/>
<attribute name="DrawAspect" type="ST_OLEDrawAspect" use="optional"/>
<attribute name="ObjectID" type="xsd:string" use="optional"/>
<attribute ref="r:id" use="optional"/>
<attribute name="UpdateMode" type="ST_OLEUpdateMode" use="optional"/>
</complexType>