posTop property

Sets or retrieves the top position of the object in the units specified by the IHTMLStyle::top attribute.

Syntax

Integer value = object.put_posTop(Floating-point v);Integer value = object.get_posTop(Floating-point* iTop);

Property values

Type: float

Any valid floating-point number that uses the same CSS Values and Units Reference as the IHTMLStyle::top attribute.

String format

float

CSS information

Applies To All elements
Media visual
Inherited no
Initial Value

Remarks

This property reflects the value of the Cascading Style Sheets (CSS) IHTMLStyle::top attribute for positioned items. This property always returns zero for nonpositioned items because "top" has meaning only when the object is positioned. If the IHTMLStyle::top attribute is not set, the IHTMLStyle::posTop property returns zero. Use the IHTMLElement::offsetTop property to calculate actual positions within the document area.

Setting this property changes the value of the top position but leaves the units designator for the property unchanged.

Unlike the IHTMLStyle::top property, the IHTMLStyle::posTop property value is a floating-point number, not a string.

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

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

IHTMLStyle::pixelTop