<wrapPolygon> (Wrapping Polygon)

This element specifies the wrapping polygon which shall be used to determine the extents to which text may wrap around the specified object in the document. This polygon shall be defined by the following:

  • The <start> element defines the coordinates of the origin of the wrap polygon

  • Two or more <lineTo> elements define the point of the wrap polygon

If the set of child elements does not result in a closed polygon (the last <lineTo> element does not return to the position specified by the <start> element), then a single additional line shall be inferred as needed to close the wrapping polygon.

example: 
<wp:wrapPolygon>
  <wp:start x="0" y="0" />
  <wp:lineTo x="0" y="100" />
  <wp:lineTo x="100" y="100" />
  <wp:lineTo x="100" y="0" />
  <wp:lineTo x="0" y="0" />
</wp:wrapPolygon>

The <wrapPolygon> element defines the object's text wrapping polygon (in this case, the four points of a square). ]

Parent Elements

<wrapThrough> (§5.5.2.18); <wrapTight> (§5.5.2.19)

Child Elements

Subclause

<lineTo> (Wrapping Polygon Line End Position)

§5.5.2.9

<start> (Wrapping Polygon Start)

§5.5.2.14

Attributes

Description

<edited> (Wrapping Points Modified)

Specifies that the wrap points for the wrapping polygon have been edited, and the resulting extents shall be recalculated to compensate when the document is next opened.

<wp:wrapPolygon edited="true">
  <wp:start x="0" y="0" />
  <wp:lineTo x="0" y="100" />
  <wp:lineTo x="50" y="50" />
  <wp:lineTo x="0" y="0" />
</wp:wrapPolygon>

The @edited attribute specifies that these wrap points have been changed since the document was last rendered. ]

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

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

<complexType name="CT_WrapPath">
	<sequence>
	<element name="start" type="a:CT_Point2D" minOccurs="1" maxOccurs="1"/>
	<element name="lineTo" type="a:CT_Point2D" minOccurs="2" maxOccurs="unbounded"/>
	</sequence>
	<attribute name="edited" type="xsd:boolean" use="optional"/>
</complexType>