20.4.2.20 wrapTopAndBottom

20 DrawingML - Framework Reference Material

20.4 DrawingML - WordprocessingML Drawing

This element specifies that text shall wrap around the top and bottom of this object, but not its left or right edges.

[Example: Consider a DrawingML object using top and bottom wrapping and defined as follows:

<wp:anchor … >
  …
  <wp:wrapTopAndBottom />
</wp:anchor>

The wrapTopAndBottom element specifies that text must wrap around neither side of this object. end example]

Attributes

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).

[Example: Consider a floating DrawingML object which must 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
                  … >
        …
        <wp:wrapTopAndBottom
    </wp:anchor>
                          distT="457200" … />

The distT attribute specifies that the padding distance must 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 (20.4.3.6).

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).

[Example: Consider a floating DrawingML object which must 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
                  … >
        …
        <wp:wrapTopAndBottom distB="457200" … />
    </wp:anchor>

The distB attribute specifies that the padding distance must 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 (20.4.3.6).

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

This element defines formatting that can be applied to the background shape of the document. The background shape can hold formatting options just as a normal shape can hold within DrawingML.

This element defines the body properties for the text body within a shape.

Attributes

compatLnSpc (Compatible Line

Specifies that the line spacing for this text body is decided in a simplistic manner using the font scene. If this attribute is omitted, a value of 0 or false is implied.

bIns (Bottom Inset)

Specifies the bottom inset of the bounding rectangle. Insets are used just as internal margins for text boxes within shapes. If this attribute is omitted, a value of 45720 or 0.05 inches is implied.

The possible values for this attribute are defined by the ST_Coordinate32 simple type (20.1.10.17).

anchorCtr (Anchor Center)

Specifies the centering of the text box. The way it works fundamentally is to determine the smallest possible “bounds box” for the text and then to center that “bounds box” accordingly. This is different than paragraph alignment, which aligns the text within the “bounds box” for the text. This flag is compatible with all of the different kinds of anchoring. If this attribute is omitted, then a value of 0 or false is implied.

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

anchor (Anchor)

Specifies the anchoring position of the txBody within the shape. If this attribute is omitted, then a value of t, or top is implied.

The possible values for this attribute are defined by the ST_TextAnchoringType simple type (20.1.10.60).

rIns (Right Inset)

Specifies the right inset of the bounding rectangle. Insets are used just as internal margins for text boxes within shapes. If this attribute is omitted, then a value of 91440 or 0.1 inches is implied.

The possible values for this attribute are defined by the ST_Coordinate32 simple type (20.1.10.17).

numCol (Number of Columns)

Specifies the number of columns of text in the bounding rectangle. When applied to a text run this property takes the width of the bounding box for the text and divides it by the number of columns specified. These columns are then treated as overflow containers in that when the previous column has been filled with text the next column acts as the repository for additional text. When all columns have been filled and text still remains then the overflow properties set for this text body are used and the text is reflowed to make room for additional text. If this attribute is omitted, then a value of 1 is implied.

The possible values for this attribute are defined by the ST_TextColumnCount simple type (20.1.10.65).

lIns (Left Inset)

Specifies the left inset of the bounding rectangle. Insets are used just as internal margins for text boxes within shapes. If this attribute is omitted, then a value of 91440 or 0.1 inches is implied.

The possible values for this attribute are defined by the ST_Coordinate32 simple type (20.1.10.17).

horzOverflow (Text Horizontal Overflow)

Determines whether the text can flow out of the bounding box horizontally. This is used to determine what happens in the event that the text within a shape is too large for the bounding box it is contained within. If this attribute is omitted, then a value of overflow is implied.

The possible values for this attribute are defined by the ST_TextHorzOverflowType simple type (20.1.10.69).

fromWordArt (From WordArt)

Specifies that text within this textbox is converted text from a WordArt object. This is more of a backwards compatibility attribute that is useful to the application from a tracking perspective. WordArt was the former way to apply text effects and therefore this attribute is useful in document conversion scenarios. If this attribute is omitted, then a value of 0 or false is implied.

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

forceAA (Force Anti-Alias)

Forces the text to be rendered anti-aliased regardless of the font size. Certain fonts can appear grainy around their edges unless they are anti-aliased. Therefore this attribute allows for the specifying of which bodies of text should always be anti-aliased and which ones should not. If this attribute is omitted, then a value of 0 or false is implied.

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

Spacing)

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

upright (Text

Specifies whether the before and after paragraph spacing defined by the user is to be respected. While the spacing between paragraphs is helpful, it is additionally useful to be able to set a flag as to whether this spacing is to be followed at the edges of the text body, in other words the first and last paragraphs in the text body. More precisely since this is a text body level property it should only effect the before paragraph spacing of the first paragraph and the after paragraph spacing of the last paragraph for a given text body. If this attribute is omitted, then a value of 0, or false is implied.

Specifies whether text should remain upright, regardless of the transform applied to it

tIns (Top Inset)

Specifies the top inset of the bounding rectangle. Insets are used just as internal margins for text boxes within shapes. If this attribute is omitted, then a value of 45720 or 0.05 inches is implied.

The possible values for this attribute are defined by the ST_Coordinate32 simple type (20.1.10.17).

spcFirstLastPara (Paragraph Spacing)

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

spcCol (Space Between Columns)

Specifies the space between text columns in the text area. This should only apply when there is more than 1 column present. If this attribute is omitted, then a value of 0 is implied.

The possible values for this attribute are defined by the ST_PositiveCoordinate32 simple type (20.1.10.43).

rtlCol (Columns Right-To-Left)

Specifies whether columns are used in a right-to-left or left-to-right order. The usage of this attribute only sets the column order that is used to determine which column overflow text should go to next. If this attribute is omitted, then a value of 0 or falseis implied in which case text starts in the leftmost column and flow to the right.

[Note: This attribute in no way determines the direction of text but merely the direction in which multiple columns are used. end note]

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

rot (Rotation)

Specifies the rotation that is being applied to the text within the bounding box. If it not specified, the rotation of the accompanying shape is used. If it is specified, then this is applied independently from the shape. That is the shape can have a rotation applied in addition to the text itself having a rotation applied to it. If this attribute is omitted, then a value of 0, is implied.

The possible values for this attribute are defined by the ST_Angle simple type (20.1.10.3).

wrap (Text Wrapping Type)

Specifies the wrapping options to be used for this text body. If this attribute is omitted, then a value of square is implied which wraps the text using the bounding text box.

The possible values for this attribute are defined by the ST_TextWrappingType simple type (20.1.10.85).

vertOverflow (Text Vertical Overflow)

Determines whether the text can flow out of the bounding box vertically. This is used to determine what happens in the event that the text within a shape is too large for the bounding box it is contained within. If this attribute is omitted, then a value of overflow is implied.

The possible values for this attribute are defined by the ST_TextVertOverflowType simple type (20.1.10.84).

vert (Vertical Text)

Determines if the text within the given text body should be displayed vertically. If this attribute is omitted, then a value of horz, or no vertical text is implied.

The possible values for this attribute are defined by the ST_TextVerticalType simple type (20.1.10.83).

Upright)

and the accompanying shape transform. If this attribute is omitted, then a value of 0, or false is implied.

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

This element specifies the non-visual drawing properties specific to a connector shape. This includes information specifying the shapes to which the connector shape is connected.

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

This element specifies the non-visual drawing properties for a content part. This allows for additional information that does not affect the appearance of the content part to be stored.

Attributes

Namespace: http://purl.oclc.or g/ooxml/drawing ml/main

The default value for this attribute is true.

[Example: Consider a WordprocessingDrawingML object defined as follows:

    <… isComment="false">

The content part shape does not represent a comment. end example]

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

isComment (Is a Comment)

Specifies whether the content part is a comment or an annotation. If true, it is a comment; otherwise, it is a general annotation.

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

This element specifies the non-visual drawing properties for a graphic frame. These non-visual properties are properties that the generating application would utilize when rendering.

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

This element specifies the non-visual drawing properties for a group shape. These non-visual properties are properties that the generating application would utilize when rendering.

This element specifies non-visual canvas properties. This allows for additional information that does not affect the appearance of the picture to be stored.

[Example: Consider the following WordprocessingDrawingML:

<wsp>
  …
  <cNvPr id="4" name="Lilly_by_Lisher.jpg"/>
  …
</wsp>

end example]

Attributes

Namespace: http://purl.oclc.or g/ooxml/drawing ml/main

If this element is omitted, then no alternative text is present for the parent object.

[Example: Consider a DrawingML object defined as follows:

    <… descr="A picture of a bowl of fruit">

The descr attribute contains alternative text that can be used in place of the actual DrawingML object. end example]

The possible values for this attribute are defined by the W3C XML Schema string datatype.

descr (Alternative Text for Object)

Specifies alternative text for the current DrawingML object, for use by assistive technologies or applications that do not display the current object.

Namespace: http://purl.oclc.or

[Example: Consider a DrawingML object defined as follows:

name (Name)

Specifies the name of the object. [Note: Typically, this is used to store the original file name of a picture object. end note]

Namespace: http://purl.oclc.or g/ooxml/drawing ml/main

If multiple objects within the same document share the same id attribute value, then the document shall be considered non-conformant.

[Example: Consider a DrawingML object defined as follows:

    <… id="10" … >

The id attribute has a value of 10, which is the unique identifier for this DrawingML object. end example]

The possible values for this attribute are defined by the ST_DrawingElementId simple type (20.1.10.21).

id (Unique Identifier)

Specifies a unique identifier for the current DrawingML object within the current document. This ID can be used to assist in uniquely identifying this object so that it can be referred to by other parts of the document.

Namespace: http://purl.oclc.or g/ooxml/drawing ml/main

If this attribute is omitted, then the parent DrawingML object shall be displayed (i.e., not hidden).

[Example: Consider an inline DrawingML object that must be hidden within the document’s content. This setting would be specified as follows:

    <… hidden="true" />

The hidden attribute has a value of true, which specifies that the DrawingML object is hidden and not displayed when the document is displayed. end example]

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

hidden (Hidden)

Specifies whether this DrawingML object is displayed. When a DrawingML object is displayed within a document, that object can be hidden (i.e., present, but not visible). This attribute determines whether the object is rendered or made hidden. [Note: An application can have settings which allow this object to be viewed. end note]

Namespace: http://purl.oclc.or g/ooxml/drawing ml/main

If this attribute is omitted, then no title text is present for the parent object.

[Example: Consider a DrawingML object defined as follows:

    <… title="Process Flow Diagram">

end example]

The possible values for this attribute are defined by the W3C XML Schema string datatype.

title (Title)

Specifies the title (caption) of the current DrawingML object.

g/ooxml/drawing ml/main

    < … name="foo.jpg" >

The name attribute has a value of foo.jpg, which is the name of this DrawingML object. end example]

The possible values for this attribute are defined by the W3C XML Schema string datatype.

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

This element specifies the non-visual drawing properties for a shape. These properties are to be used by the generating application to determine how the shape should be dealt with.

Attributes

Namespace: http://purl.oclc.or g/ooxml/drawing ml/main

[Note: Because a shape is not specified to be a text box does not mean that it cannot have text attached to it. A text box is merely a specialized shape with specific properties. end note]

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

txBox (Text Box)

Specifies that the corresponding shape is a text box and thus should be treated as such by the generating application. If this attribute is omitted then it is assumed that the corresponding shape is not specifically a text box.

This element specifies a reference to XML content in a format not defined by ECMA-376. [Note: This part allows the native use of other commonly used interchange formats, such as:

end note]

The relationship type of the explicit relationship specified by this element shall be http://purl.oclc.org/ooxml/officeDocument/relationships/customXml and have a TargetMode attribute value of Internal. If an application cannot process content of the content type specified by the targeted part, then it should continue to process the file. If possible, it should also provide some indication that unknown content was not imported.

Attributes

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

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

<… r:id=“rId10” />

The markup specifies the associated relationship part with relationship ID rId1 contains the corresponding relationship information for the parent XML element. end example]

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

id (Relationship to Part)

Specifies the relationship ID to a specified part.

The specified relationship shall match the relationship type required by the parent element:

http://purl.oclc.org/ooxml/officeDocument/customXml for the contentPart element
http://purl.oclc.org/ooxml/officeDocument/relationships/footer for the footerReference element
http://purl.oclc.org/ooxml/officeDocument/relationships/header for the headerReference element
http://purl.oclc.org/ooxml/officeDocument/relationships/font for the embedBold, embedBoldItalic, embedItalic, or embedRegular elements
http://purl.oclc.org/ooxml/officeDocument/relationships/printerSettings for the printerSettings element
http://purl.oclc.org/ooxml/officeDocument/relationships/hyperlink for the longDesc or hyperlink element

bwMode (Black and White Mode)

Specifies how to interpret color information contained within a content part to achieve a color, black and white, or grayscale rendering of the content part. This attribute specifies only the rendering mode applied to the content part; it does not affect how the actual color information is persisted.

The possible values for this attribute are defined by the ST_BlackWhiteMode simple type (20.1.10.10).

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

Last updated on March 14, 2025

20.4.2.19 wrapTight 20.4.2.30 extLst