backgroundRepeat property

[This documentation is preliminary and is subject to change.]

Sets or retrieves how the background-image property of the object is tiled.

Syntax

Integer value = object.put_backgroundRepeat(BSTR v);Integer value = object.get_backgroundRepeat(BSTR* sRepeat);

Property values

Type: BSTR

repeat (repeat)

Default. Image is repeated horizontally and vertically.

no-repeat (no-repeat)

Image is not repeated.

repeat-x (repeat-x)

Image is repeated horizontally.

repeat-y (repeat-y)

Image is repeated vertically.

inherit

String format

repeat | repeat-x | repeat-y | no-repeat

CSS information

Standards information

• CSS 2.1, Section 5.3.4

Remarks

The repeat-x and repeat-y values make the image repeat horizontally and vertically, respectively, creating a single band of images from one side to the other.

This property can be set with other background properties by using the background composite property.

In Windows Internet Explorer 9, the background of a box can have multiple layers. The number of layers is determined by the number of comma-separated values in the background-image property. Each of the images is sized, positioned, and tiled according to the corresponding value in the other background properties (background-attachment, background-clip, background-origin, background-position, background-repeat, and background-size). The first image in the list is the layer closest to the user, the next one is painted behind the first, and so on.

Requirements

Build date: 1/23/2012