WrapTight Class

Article
08/03/2013

Tight Wrapping.When the object is serialized out as xml, its qualified name is wp:wrapTight.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Drawing.Wordprocessing.WrapTight

Namespace: DocumentFormat.OpenXml.Drawing.Wordprocessing
Assembly: DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(WrapPolygon))> _
Public Class WrapTight _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As WrapTight

[ChildElementInfoAttribute(typeof(WrapPolygon))]
public class WrapTight : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

WrapPolygon <wp:wrapPolygon>

[ISO/IEC 29500-1 1st Edition]

20.4.2.19 wrapTight (Tight Wrapping)

This element specifies that text shall wrap around the wrapping polygon bounding this object as defined by the child wrapPolygon element. When this element specifies a wrapping polygon, it shall not allow text to wrap within the object's maximum left and right extents.

[Example: Consider an object with the following wrap points:

DocumentFormat.OpenXml.Drawing.Wordprocessing.Wrap

If this object uses tight wrapping, then text cannot be placed within the maximum left and right extents of the wrap polygon at any location:

DocumentFormat.OpenXml.Drawing.Wordprocessing.Wrap

However, with through wrapping:

DocumentFormat.OpenXml.Drawing.Wordprocessing.Wrap

end example]

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

<wp:anchor … >
  …
<wp:wrapTight wrapText="bothSides">
…
</wp:wrapTight>
</wp:anchor>

The wrapTight element specifies that text must wrap through this object as defined by its wrap polygon. end example]

Parent Elements
anchor (§20.4.2.3)

Child Elements	Subclause
wrapPolygon (Wrapping Polygon)	§20.4.2.16

Attributes	Description
distL (Distance From Test 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). [Example: Consider a floating DrawingML object which must have one-half of an inch of padding between its left edge and the nearest text. This setting would be specified as follows: `<wp:anchor … > … <wp:wrapTight distL="457200" … /> </wp:anchor>` The distL 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).
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). [Example: Consider a floating DrawingML object which must have one-half of an inch of padding between its right edge and the nearest text. This setting would be specified as follows: `<wp:anchor … > … <wp:wrapTight distR="457200" … /> </wp:anchor>` The distR 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).
wrapText (Text Wrapping Location)	Specifies how text shall wrap around the object's left and right sides. [Example: Consider a floating DrawingML object which must allow text to wrap around its left side only. This setting would be specified as follows: `<wp:anchor … > … <wp:wrapTight wrapText="left" … /> </wp:anchor>` The wrapText attribute value of left specifies that text must only wrap around the let side of the object. end example] The possible values for this attribute are defined by the ST_WrapText simple type (§20.4.3.7).

Attributes

Description

distL (Distance From Test 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).

[Example: Consider a floating DrawingML object which must have one-half of an inch of padding between its left edge and the nearest text. This setting would be specified as follows:

<wp:anchor … >
…
  <wp:wrapTight distL="457200" … />
</wp:anchor>

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

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

[Example: Consider a floating DrawingML object which must have one-half of an inch of padding between its right edge and the nearest text. This setting would be specified as follows:

<wp:anchor … >
…
  <wp:wrapTight distR="457200" … />
</wp:anchor>

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

wrapText (Text Wrapping Location)

Specifies how text shall wrap around the object's left and right sides.

[Example: Consider a floating DrawingML object which must allow text to wrap around its left side only. This setting would be specified as follows:

<wp:anchor … >
…
  <wp:wrapTight wrapText="left" … />
</wp:anchor>

The wrapText attribute value of left specifies that text must only wrap around the let side of the object. end example]

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

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

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

WrapTight Class

Inheritance Hierarchy

Syntax

Remarks

Thread Safety

See Also

Reference

Additional resources