top Property

MS Office DHTML, HTML & CSS

top Property


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

Syntax

HTMLN/A
Scripting[ iCoord = ] oTextRectangle.top

Possible Values

iCoordInteger 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.
Microsoft Internet Explorer

Applies To

[ Object Name ]
PlatformVersion
Win16:
Win32:
Mac:
Unix:
WinCE:
Version data is listed when the mouse hovers over a link, or the link has focus.
TextRectangle

See Also

TextRectangle Collection, TextRectangle Object, bottom, left, right


Back to topBack to top

Did you find this topic useful? Suggestions for other topics? write us!Internet Link

© 1999 microsoft corporation. all rights reserved. terms of useInternet Link.