[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

background2.2.1); hdrShapeDefaults2.15.1.50); object2.3.3.19); pict2.3.3.21); pict2.9.23); shapeDefaults2.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>