selectionChanged

Sent to a field or player when the selection is changed.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

selectionChanged

# Examples

on selectionChanged -- display selected char number put word 2 of the selectedChunk into field "Character Number" end selectionChanged

# Description

Handle the selectionChanged message if you want to perform updates or do some action when the user changes the selected text of a field or the selected portion of a player.

The selectionChanged message is sent to a field whenever the user makes a text selection or moves the insertion point in the field, after the selection is changed.

>*Note:* If the selection change is a result of the text being added or removed (for example, cut or paste over selected text), selectionChanged will not be sent, but rather textChanged.

The selectionChanged message is sent to a player whenever the user selects a portion of the sound or movie, or when a handler sets the player startTime or endTime property.

>*Note:* If an already-selected-item in a list is reselected a > selectionChanged message will still be sent.

# Tags

ui,

# See

- **keyword:** selection, field, player - **property:** selected, startTime, endTime - **message:** currentTimeChanged, selectedObjectChanged, textChanged, arrowKey - **command:** select - **object:** player - **glossary:** handler, insertion point, message, field, property, select