backgroundRepeat property
Specifies whether and how the background image is tiled.
![]() |
Syntax
Integer value = object.put_backgroundRepeat( v);Integer value = object.get_backgroundRepeat(* sRepeat);
Property values
Type: BSTR
repeat (repeat)
-
Default. Image is repeated horizontally and vertically.
repeat-x (repeat-x)
-
Image is repeated horizontally.
repeat-y (repeat-y)
-
Image is repeated vertically.
inherit
no-repeat (no-repeat)
-
Image is not repeated.
String format
repeat-x | repeat-y | [ repeat | space | round | no-repeat ] {1,2}
CSS information
| Applies To | All elements |
|---|---|
| Media | visual |
| Inherited | no |
| Initial Value | repeat |
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 IHTMLRuleStyle::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 IHTMLCurrentStyle::backgroundImage property. Each of the images is sized, positioned, and tiled according to the corresponding value in the other background properties (IHTMLCurrentStyle::backgroundAttachment, IHTMLCSSStyleDeclaration::backgroundClip, IHTMLCSSStyleDeclaration::backgroundOrigin, IHTMLRuleStyle::backgroundPosition, IHTMLCurrentStyle::backgroundRepeat, and IHTMLCSSStyleDeclaration::backgroundSize). 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
|
Minimum supported client | Windows XP |
|---|---|
|
Minimum supported server | Windows Server 2003 |
|
Header |
|
|
IDL |
|
|
DLL |
|
Build date: 11/12/2012
