top Property

DHTML, HTML, & CSS

previous page next page

top Property

TOPMARGIN Attribute | top...

DHTML Properties

Web Workshop | DHTML, HTML & CSS

top Property

Retrieves the top coordinate of the rectangle surrounding the object content.

Syntax

HTML N/A

Scripting [ iCoord = ] oTextRectangle.top

HTML	N/A
Scripting	[ iCoord = ] oTextRectangle.top

Possible Values

iCoord Integer that specifies the top coordinate of the rectangle, in pixels.

The property is read-only with no default value.

Remarks

Use this syntax to access the top coordinate of the second text rectangle of a TextRange object:
oRct = oTextRange.getClientRects();
oRct[1].top;
Note that the collection index starts at 0, so the second item index is 1.

To access the top coordinate of the bounding rectangle of an object, use this syntax:
oBndRct = oElement.getBoundingClientRect();
oBndRct.top;

Example

This example uses the getBoundingClientRect method to retrieve the coordinates of the bounds of the text rectangles within the element.

Sample Code
<SCRIPT>
function getCoords(oObject) {
    oBndRct=oObject.getBoundingClientRect();
    alert("Bounding rectangle = \nUpper left coordinates: "
        + oBndRct.left + " " + oBndRct.top +
        "\nLower right coordinates: "
        + oBndRct.right + " " + oBndRct.bottom);
}
</SCRIPT>
</HEAD>	
<BODY>
<P ID=oPara onclick="getCoords(this)">
This feature requires Microsoft® Internet Explorer 5 or later. Click the icon below to install the latest version. Then reload this page to view the sample.

Applies To

[ Object Name ]

Platform Version

Win16:

Win32:

Mac:

Unix:

WinCE:

Version data is listed when the mouse hovers over a link, or the link has focus.

TextRectangle