17.3.3.20 objectEmbed

This element specifies the visual properties and associated server application of an embedded object.

[Example: The following demonstrates a video file embedded in a WordprocessingML document:

<w:object … >
  <w:drawing> … </w:drawing>
  <w:objectEmbed drawAspect="content" r:id="rId3" progId="AVIFile"
shapeId="10"/>
</w:object>

end example]

Attributes

Namespace: http://purl.oclc.or g/ooxml/officeDoc ument/relationshi ps

[Example: Consider an XML element which has the following id attribute:

  <… r:id="rId1" />

The markup specifies the associated relationship part with relationship ID rId1 targets

the part containing the corresponding embedded object information. end example]

The possible values for this attribute are defined by the ST_RelationshipId simple type (22.8.2.1).

id (Relationship to Embedded Object Data)

Specifies the relationship ID for the relationship which targets the Embedded Object Part containing the embedded object data.

The specified relationship shall be of type http://purl.oclc.org/ooxml/officeDocument/relationships/oleObject or the document shall be considered non-conformant.

fieldCodes (Field Switches)

This element specifies the WordprocessingML field switches which shall be stored with an embedded object, using the set of field switches defined by the LINK field, as specified in 17.16.5.32. This element shall specify the exact field switches for the field which represents the object.

[Rationale: Legacy word processors used fields to represent embedded objects - this element stores the field switches not explicitly defined for embeddings so as not to lose the fidelity of their contents. end rationale]

[Example:

  <w:objectEmbed
              … fieldCodes="\f 0"/>

This embedded object specifies additional LINK field code values of \f 0, which specifies that the embedded object must retain its source formatting (as defined in 17.16.5.32). end example]

If this attribute is omitted, the parent element shall be ignored.

The possible values for this attribute are defined by the ST_String simple type (22.9.2.13).

drawAspect (Object Representation)

Specifies how the object is represented visually in the application.

[Example:

  <w:objectEmbed
              … drawAspect="content"/>

end example]

If this attribute is omitted, the parent element shall be ignored.

The possible values for this attribute are defined by the ST_ObjectDrawAspect simple type (17.18.60).

shapeId (Object Shape)

Specifies the shape with which the object is associated. A shape provides the visual placeholder for an object and this attribute is set to the ID of the placeholder shape.

[Example:

  <w:objectEmbed
              … shapeId="10"/>

end example]

If this attribute is omitted, the parent element shall be ignored.

The possible values for this attribute are defined by the ST_String simple type (22.9.2.13).

progId (Object Application)

Specifies the application associated with the object.

[Example:

  <w:objectEmbed
              … progId="AVIFile"/>

end example]

If this attribute is omitted, the parent element shall be ignored.

The possible values for this attribute are defined by the ST_String simple type (22.9.2.13).

[Note: The W3C XML Schema definition of this element’s content model (CT_ObjectEmbed) is located in A.1. end note]