onscroll Event

Fires when the user repositions the scroll box in the scroll bar on the object.

Syntax

Inline HTML <ELEMENT onscroll = "handler" ... > All platforms

Event property object.onscroll = handler JScript (compatible with ECMA 262 language specification) only

Named script <SCRIPT FOR = object EVENT = onscroll> Internet Explorer only

Inline HTML	<ELEMENT onscroll = "handler" ... >	All platforms
Event property	object.onscroll = handler	JScript (compatible with ECMA 262 language specification) only
Named script	<SCRIPT FOR = object EVENT = onscroll>	Internet Explorer only

Remarks

Bubbles No

Cancels No

To invoke Begin scrolling in the object that has a scroll bar:

Click and drag the scroll box with the mouse.
Click the scroll arrow.
Click the scroll bar.
Invoke the doScroll method.
Press the PAGE UP or PAGE DOWN key.
Press the ARROW UP or ARROW DOWN key until scrolling occurs.

Default action Scrolls the contents of an object until new portions of the object become visible.

Use the componentFromPoint and doScroll methods to control the scroll bar components.

Cascading style sheets (CSS) enable scrolling on all objects through the overflow property. These objects are not listed in the Applies To list for this event.

Bubbles	No
Cancels	No
To invoke	Begin scrolling in the object that has a scroll bar: Click and drag the scroll box with the mouse. Click the scroll arrow. Click the scroll bar. Invoke the doScroll method. Press the PAGE UP or PAGE DOWN key. Press the ARROW UP or ARROW DOWN key until scrolling occurs.
Default action	Scrolls the contents of an object until new portions of the object become visible.

Event Object Properties

Although event handlers in the DHTML Object Model do not receive parameters directly, the handler can query the event object for data.
Event Object Properties

clientX Retrieves the x-coordinate of the mouse cursor relative to the client area of the window, excluding window decorations or scroll bars.

clientY Retrieves the y-coordinate of the mouse cursor relative to the client area of the window, excluding window decorations or scroll bars.

offsetX Retrieves the horizontal coordinate of the mouse's position relative to the object firing the event.

offsetY Retrieves the vertical coordinate of the mouse's position relative to the object firing the event.

screenX Retrieves the horizontal position of the mouse, in pixels, relative to the user's screen.

screenY Retrieves the vertical position of the mouse, in pixels, relative to the user's screen.

srcElement Retrieves the object that fired the event.

type Retrieves the event name from the event object.

x Retrieves the x-coordinate of the mouse cursor relative to the parent element.

y Retrieves the y-coordinate of the mouse cursor relative to the parent element.

clientX	Retrieves the x-coordinate of the mouse cursor relative to the client area of the window, excluding window decorations or scroll bars.
clientY	Retrieves the y-coordinate of the mouse cursor relative to the client area of the window, excluding window decorations or scroll bars.
offsetX	Retrieves the horizontal coordinate of the mouse's position relative to the object firing the event.
offsetY	Retrieves the vertical coordinate of the mouse's position relative to the object firing the event.
screenX	Retrieves the horizontal position of the mouse, in pixels, relative to the user's screen.
screenY	Retrieves the vertical position of the mouse, in pixels, relative to the user's screen.
srcElement	Retrieves the object that fired the event.
type	Retrieves the event name from the event object.
x	Retrieves the x-coordinate of the mouse cursor relative to the parent element.
y	Retrieves the y-coordinate of the mouse cursor relative to the parent element.

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.

APPLET, BDO, BODY, custom, DIV, EMBED, MAP, MARQUEE, OBJECT, SELECT, TABLE, TEXTAREA