[Table of Contents] [docx version]
Error! No text of specified style in document.
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: Consider a WordprocessingML document where an inline DrawingML object shall be the first piece of run content within a paragraph. That paragraph's content would be specified as follows:
<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. end example]
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 [Example: wrapThrough or wrapSquare end example] present as a child element also has a distance from text, then this value shall be ignored.
[Example: Consider a floating DrawingML object which shall have one-half of an inch of padding between its bottom edge and the nearest text. This setting would be specified as follows:
<wp:anchor distB="457200" … >
The distB attribute specifies that the padding distance shall be 457200 EMUs or one-half of an inch. end example]
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 [Example: wrapThrough or wrapSquare end example] present as a child element also has a distance from text, then this value shall be ignored.
[Example: Consider a floating DrawingML object which shall have one-quarter of an inch of padding between its left edge and the nearest text. This setting would be specified as follows:
<wp:anchor distL="228600" … >
The distL attribute specifies that the padding distance shall be 228600 EMUs or one-quarter of an inch. end example]
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 [Example: wrapThrough or wrapSquare end example] present as a child element also has a distance from text, then this value shall be ignored.
[Example: Consider a floating DrawingML object which shall have one-quarter of an inch of padding between its right edge and the nearest text. This setting would be specified as follows:
<wp:anchor distR="228600" … >
The distR attribute specifies that the padding distance shall be 228600 EMUs or one-quarter of an inch. end example]
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 [Example: wrapThrough or wrapSquare end example] present as a child element also has a distance from text, then this value shall be ignored.
[Example: Consider a floating DrawingML object which shall have one-half of an inch of padding between its top edge and the nearest text. This setting would be specified as follows:
<wp:anchor distT="457200" … >
The distT attribute specifies that the padding distance shall be 457200 EMUs or one-half of an inch. end example]
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>