User Guide

714 Chapter 2: ActionScript Language Reference
Selection class
Availability
Flash Player 5.
Description
The Selection class lets you set and control the text field in which the insertion point is located
(that is, the field that has focus). Selection-span indexes are zero-based (for example, the first
position is 0, the second position is 1, and so on).
There is no constructor function for the Selection class, because there can be only one currently
focused field at a time.
Method summary for the Selection class
Listener summary for the Selection class
Method Description
Selection.addListener()
Registers an object to receive notification when onSetFocus is
invoked.
Selection.getBeginIndex()
Returns the index at the beginning of the selection span. Returns -1 if
there is no index or currently selected field.
Selection.getCaretIndex()
Returns the current caret (insertion point) position in the currently
focused selection span. Returns -1 if there is no caret position or
currently focused selection span.
Selection.getEndIndex()
Returns the index at the end of the selection span. Returns -1 if there
is no index or currently selected field.
Selection.getFocus()
Returns the name of the variable for the currently focused text field.
Returns
null if there is no currently focused text field.
Selection.removeListener()
Removes an object that was registered with addListener().
Selection.setFocus()
Focuses the text field associated with the specified variable.
Selection.setSelection()
Sets the beginning and ending indexes of the selection span.
Listener Description
Selection.onSetFocus
Notified when the input focus changes.
CHAPTER 2
ActionScript Language Reference