<inline> (Inline DrawingML Object)

This element specifies that the DrawingML object located at this position in the document is an inline object. Within a WordprocessingML document, drawing objects can exist in two states:

  • Inline - The drawing object is in line with the text, and affects the line height and layout of its line (like a character glyph of similar size).

  • Floating - The drawing object is anchored within the text, but may be absolutely positioned in the document relative to the page.

When this element encapsulates the DrawingML object's information, then all child elements shall dictate the positioning of this object in line with text.

example: 
<w:p>
  <w:r>
    <w:drawing>
      <wp:inline>
        …
      </wp:inline>
    </w:drawing>
  </w:r>
</w:p>

The <inline> element, when present as the child element of the <drawing> element, specifies that this DrawingML object shall be positioned in line with the text of this paragraph, modifying line heights, etc. as necessary. ]

Parent Elements

<drawing> (§2.3.3.9)

Child Elements

Subclause

<cNvGraphicFramePr> (Common DrawingML Non-Visual Properties)

§5.5.2.4

<docPr> (Drawing Object Non-Visual Properties)

§5.5.2.5

<effectExtent> (Object Extents Including Effects)

§5.5.2.6

<extent> (Drawing Object Size)

§5.5.2.7

<graphic> (Graphic Object)

§5.1.2.1.16

Attributes

Description

<distB> (Distance From Text on Bottom Edge)

Specifies the minimum distance which shall be maintained between the bottom edge of this drawing object and any subsequent text within the document when this graphical object is displayed within the document's contents.

The distance shall be measured in EMUs (English Metric Units).

If this object is an inline object (i.e. has a parent element of <inline>), then this value shall not have any effect when displaying the object in line with text, but may be maintained and used if the object is subsequently changed to floating. If the wrapping element [: <wrapThrough> or <wrapSquare> ] present as a child element also has a distance from text, then this value shall be ignored.

<wp:anchor distB="457200" … >
  …
</wp:anchor>

The @distB attribute specifies that the padding distance shall be 457200 EMUs or one-half of an inch. ]

The possible values for this attribute are defined by the ST_WrapDistance simple type (§5.5.3.6).

<distL> (Distance From Text on Left Edge)

Specifies the minimum distance which shall be maintained between the left edge of this drawing object and any subsequent text within the document when this graphical object is displayed within the document's contents.

The distance shall be measured in EMUs (English Metric Units).

If this object is an inline object (i.e. has a parent element of <inline>), then this value shall not have any effect when displaying the object in line with text, but may be maintained and used if the object is subsequently changed to floating. If the wrapping element [: <wrapThrough> or <wrapSquare> ] present as a child element also has a distance from text, then this value shall be ignored.

<wp:anchor distL="228600" … >
  …
</wp:anchor>

The @distL attribute specifies that the padding distance shall be 228600 EMUs or one-quarter of an inch. ]

The possible values for this attribute are defined by the ST_WrapDistance simple type (§5.5.3.6).

<distR> (Distance From Text on Right Edge)

Specifies the minimum distance which shall be maintained between the right edge of this drawing object and any subsequent text within the document when this graphical object is displayed within the document's contents.

The distance shall be measured in EMUs (English Metric Units).

If this object is an inline object (i.e. has a parent element of <inline>), then this value shall not have any effect when displaying the object in line with text, but may be maintained and used if the object is subsequently changed to floating. If the wrapping element [: <wrapThrough> or <wrapSquare> ] present as a child element also has a distance from text, then this value shall be ignored.

<wp:anchor distR="228600" … >
  …
</wp:anchor>

The @distR attribute specifies that the padding distance shall be 228600 EMUs or one-quarter of an inch. ]

The possible values for this attribute are defined by the ST_WrapDistance simple type (§5.5.3.6).

<distT> (Distance From Text on Top Edge)

Specifies the minimum distance which shall be maintained between the top edge of this drawing object and any subsequent text within the document when this graphical object is displayed within the document's contents.

The distance shall be measured in EMUs (English Metric Units).

If this object is an inline object (i.e. has a parent element of <inline>), then this value shall not have any effect when displaying the object in line with text, but may be maintained and used if the object is subsequently changed to floating. If the wrapping element [: <wrapThrough> or <wrapSquare> ] present as a child element also has a distance from text, then this value shall be ignored.

<wp:anchor distT="457200" … >
  …
</wp:anchor>

The @distT attribute specifies that the padding distance shall be 457200 EMUs or one-half of an inch. ]

The possible values for this attribute are defined by the ST_WrapDistance simple type (§5.5.3.6).

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_Inline">
	<sequence>
	<element name="extent" type="a:CT_PositiveSize2D"/>
	<element name="effectExtent" type="CT_EffectExtent" minOccurs="0"/>
	<element name="docPr" type="a:CT_NonVisualDrawingProps" minOccurs="1" maxOccurs="1"/>
	<element name="cNvGraphicFramePr" type="a:CT_NonVisualGraphicFrameProperties" minOccurs="0" maxOccurs="1"/>
	<element ref="a:graphic" minOccurs="1" maxOccurs="1"/>
	</sequence>
	<attribute name="distT" type="ST_WrapDistance" use="optional"/>
	<attribute name="distB" type="ST_WrapDistance" use="optional"/>
	<attribute name="distL" type="ST_WrapDistance" use="optional"/>
	<attribute name="distR" type="ST_WrapDistance" use="optional"/>
</complexType>