top property

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

Sets or retrieves the position of the object relative to the top of the next positioned object in the document hierarchy.

Syntax

Integer value = object.put_top(Variant v);Integer value = object.get_top(Variant* sTop);

Property values

Type: VARIANT

auto (auto)

Default. Default position according to the regular HTML layout of the document.

length (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 (percentage)

Integer, followed by a percent sign (%). This value is a percentage of the height of the parent object.

String format

<length> | <percentage> | auto

CSS information

Standards information

• CSS 2.1, Section 9.3.2

Remarks

The top attribute should be used only when the position attribute is set; otherwise, the value of the top attribute is ignored.

Because the value of the top property is a string, you cannot use the property to calculate the position of the object in the document.

For more information about how to access the dimension and location of objects on the document through the Dynamic HTML (DHTML) Document Object Model (DOM), see Measuring Element Dimension and Location with CSSOM in Internet Explorer 9.

Requirements

See also

Reference

pixelTop

posTop

Build date: 1/23/2012