scrollIntoView method (Internet Explorer)

Causes the object to scroll into view, aligning it either at the top or bottom of the window.

Syntax

Standards information

There are no standards that apply here.

Parameters

varargStart [in, optional]

Type: VARIANT

Variant of type Boolean that specifies one of the following values:

TRUE (true)

Default. Scrolls the object so that top of the object is visible at the top of the window.

FALSE (false)

Scrolls the object so that the bottom of the object is visible at the bottom of the window.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The scrollIntoView method is useful for immediately showing the user the result of some action without requiring the user to manually scroll through the document to find the result.

Depending on the size of the given object and the current window, this method might not be able to put the item at the very top or very bottom, but will position the object as close to the requested position as possible.

Examples

This example uses the scrollIntoView method to underline the content of the document's fifth paragraph and scroll it into view at the top of the window.

   var coll = document.all.tags("P");
   if (coll.length >= 5)
   {
      coll(4).style.textDecoration = "underline";
      coll(4).scrollIntoView(true);
   }

Send comments about this topic to Microsoft

Build date: 2/14/2012