onselectionchange

HTML (DHTML)

onselectionchange Event

Fires when the selection state of a document changes.

Syntax

Event property document.onselectionchange = handler JScript only
document.onselectionchange = GetRef("handler") Visual Basic Scripting Edition (VBScript) 5.0 or later only
Named script <SCRIPT FOR = document EVENT = onselectionchange> Internet Explorer only

Event property	document.onselectionchange = handler	JScript only
document.onselectionchange = GetRef("handler")	Visual Basic Scripting Edition (VBScript) 5.0 or later only
Named script	<SCRIPT FOR = document EVENT = onselectionchange>	Internet Explorer only

Event Information

Bubbles No
Cancels No
To invoke
Cause the selection object's type property to change.
Return a range from a different location when using the createRange method of the selection object.
Move the insertion point in an editable region of the document using the mouse or keyboard.
Refresh the page when an editable region has focus.
Start or extend a text selection by dragging the mouse or using SHIFT+an arrow key.
Make a control selection in an editable region of the document.
Add or remove an element from a multiple selection by pressing SHIFT while clicking on the element.
Delete text or an element in an editable region of the document by using the BACKSPACE key, DELETE key, CTRL+X, or the Delete command.
Insert text or an element in an editable region of the document by using CTRL+V or the Paste command.
Default action N/A

Bubbles	No
Cancels	No
To invoke	Cause the selection object's type property to change. Return a range from a different location when using the createRange method of the selection object. Move the insertion point in an editable region of the document using the mouse or keyboard. Refresh the page when an editable region has focus. Start or extend a text selection by dragging the mouse or using SHIFT+an arrow key. Make a control selection in an editable region of the document. Add or remove an element from a multiple selection by pressing SHIFT while clicking on the element. Delete text or an element in an editable region of the document by using the BACKSPACE key, DELETE key, CTRL+X, or the Delete command. Insert text or an element in an editable region of the document by using CTRL+V or the Paste command.
Default action	N/A

Event Object Properties

Although event handlers in the DHTML Object Model do not receive parameters directly, a handler can query an event object for data.
Available Properties
altKey Sets or retrieves a value that indicates the state of the ALT key.
altLeft Sets or retrieves a value that indicates the state of the left ALT key.
ctrlLeft Sets or retrieves the state of the left CTRL key.
offsetX Sets or retrieves the x-coordinate of the mouse pointer's position relative to the object firing the event.
offsetY Sets or retrieves the y-coordinate of the mouse pointer's position relative to the object firing the event.
returnValue Sets or retrieves the return value from the event.
screenX Retrieves the x-coordinate of the mouse pointer's position relative to the user's screen.
screenY Sets or retrieves the y-coordinate of the mouse pointer's position relative to the user's screen.
shiftLeft Retrieves the state of the left SHIFT key.
srcElement Sets or retrieves the object that fired the event.
type Sets or retrieves the event name from the event object.
x Sets or retrieves the x-coordinate, in pixels, of the mouse pointer's position relative to a relatively positioned parent element.
y Sets or retrieves the y-coordinate, in pixels, of the mouse pointer's position relative to a relatively positioned parent element.

altKey	Sets or retrieves a value that indicates the state of the ALT key.
altLeft	Sets or retrieves a value that indicates the state of the left ALT key.
ctrlLeft	Sets or retrieves the state of the left CTRL key.
offsetX	Sets or retrieves the x-coordinate of the mouse pointer's position relative to the object firing the event.
offsetY	Sets or retrieves the y-coordinate of the mouse pointer's position relative to the object firing the event.
returnValue	Sets or retrieves the return value from the event.
screenX	Retrieves the x-coordinate of the mouse pointer's position relative to the user's screen.
screenY	Sets or retrieves the y-coordinate of the mouse pointer's position relative to the user's screen.
shiftLeft	Retrieves the state of the left SHIFT key.
srcElement	Sets or retrieves the object that fired the event.
type	Sets or retrieves the event name from the event object.
x	Sets or retrieves the x-coordinate, in pixels, of the mouse pointer's position relative to a relatively positioned parent element.
y	Sets or retrieves the y-coordinate, in pixels, of the mouse pointer's position relative to a relatively positioned parent element.

Standards Information

There is no public standard that applies to this event.

Applies To

document