backgroundPosition property

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

Sets or retrieves the position of the background of the object.

Syntax

Integer value = object.put_backgroundPosition(BSTR v);Integer value = object.get_backgroundPosition(BSTR* sPosition);

Property values

Type: BSTR

One or two of the values listed in Possible Values.

length

Floating-point number, followed by an absolute units designator (cm, mm, in, pt, or pc) or a relative units designator (em, ex, or px). For more information about the supported length units, see CSS Values and Units Reference.

percentage

Integer, followed by a percent sign (%). The value is a percentage of the width or height of the object.

Value	Meaning
0% 0%

 

vAlignment

Vertical alignment value.

Value	Meaning
top	Vertical alignment is at the top.
center	Vertical alignment is centered.
bottom	Vertical alignment is at the bottom.

 

hAlignment

Horizontal alignment value.

Value	Meaning
left	Horizontal alignment is to the left.
center	Horizontal alignment is centered.
right	Horizontal alignment is to the right.

 

String format

[ [ percentage | length | left | center | right ] [ percentage | length | top | center | bottom ]? ] | [ [ left | center | right ] || [ top | center | bottom ] ]

CSS information

Standards information

• CSS 2.1, Section 5.3.6

Remarks

If only one value is set, that value applies to the horizontal coordinate, and the vertical is set to 50%. If both values are set, the first value applies to the horizontal coordinate and the second value applies to the vertical.

Setting the values to 0% 0% (initial value) positions the background-image to the upper left corner of the element's content block, which includes the padding.

Setting the background position using pixels positions the upper-left of the image at the specified x and y coordinates within the parent element. As the coordinates increase, the image moves to the right and down the visible area. By contrast, setting the background position with percentages uses a corresponding point on the image. At a position of 50% 50% the image is effectively centered within the visible area.

This property can be set with the other background properties 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