<tileRect> (Tile Rectangle)

This element specifies a rectangular region of the shape to which the gradient is applied. This region is then tiled across the remaining area of the shape to complete the fill. The tile rectangle is defined by percentage offsets from the sides of the shape's bounding box.

Each edge of the tile rectangle is defined by a percentage offset from the corresponding edge of the bounding box. A positive percentage specifies an inset, while a negative percentage specifies an outset. For example, a left offset of 25% specifies that the left edge of the tile rectangle is located to the right of the bounding box's left edge by an amount equal to 25% of the bounding box's width.

example:

The image above depicts a horizontal gradient with no <tileRect> element.

The image above depicts the same gradient with a <tileRect> element specifying l="50000" (50%). The right half of the shape is the tile to which the gradient is applied, and the left half of the shape contains a tiled copy of that gradient fill.

The image above depicts the same gradient with a <tileRect> element specifying l="75000" (75%). The rightmost 25% of the shape contains the tile rectangle to which the gradient is applied. This gradient is tiled three times to cover the leftmost 75% of the shape. Note that the tile rectangle is flipped horizontally when covering the shape.

Parent Elements

<gradFill> (§5.1.10.33)

Attributes

Description

<b> (Bottom Offset)

Specifies the bottom edge of the rectangle.

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

<l> (Left Offset)

Specifies the left edge of the rectangle.

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

<r> (Right Offset)

Specifies the right edge of the rectangle.

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

<t> (Top Offset)

Specifies the top edge of the rectangle.

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

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

<complexType name="CT_RelativeRect">
	<attribute name="l" type="ST_Percentage" use="optional" default="0"/>
	<attribute name="t" type="ST_Percentage" use="optional" default="0"/>
	<attribute name="r" type="ST_Percentage" use="optional" default="0"/>
	<attribute name="b" type="ST_Percentage" use="optional" default="0"/>
</complexType>