17.3.3.21 objectLink

This element specifies the visual properties, associated server application and refresh mode of an embedded linked object.

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

<w:object … >
  <w:drawing> … </w:drawing>
  <w:objectLink drawAspect="icon" r:id="rId3" progId="AVIFile" shapeId="10"
updateMode="user"/>
</w:object>

end example]

Attributes

Namespace: http://purl.oclc.org/ ooxml/officeDocum ent/relationships

[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 use 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]

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]

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

updateMode (Object Update Mode)

Specifies how the object is updated with new data - automatically or on-demand by the user.

[Example:

  <w:objectLink
              … updateMode="always"/>

end example]

The possible values for this attribute are defined by the ST_ObjectUpdateMode simple

type (17.18.61).

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]

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]

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

lockedField (Object Refresh Flag)

Specifies whether the object’s appearance is locked. If it is locked, the object’s current representation shall be locked to prevent any user interaction or automatic application behavior from modifying its contents.

[Example:

  <w:objectLink
              … lockedField="true"/>

end example]

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

The possible values for this attribute are defined by the ST_OnOff simple type (22.9.2.7).

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