ActionScript for Flash MX: The Definitive Guide, Second Edition

TextField.onSetFocus() Event Handler

This is the Title of the Book, eMatter Edition

Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.

856

|

ActionScript Language Reference

Example

The following code detects when theField_txt has been scrolled all the way to the bottom:

theField_txt.onScroller = function (scrolledField) {

if (this.scroll = = this.maxScroll) {

trace("End of field reached.");

}

}

See Also

TextField.addListener(), TextField.hscroll, TextField.maxhscroll, TextField.maxscroll,

TextField.removeListener(),

TextField.scroll; Chapter 10; the FScrollBar component in

Appendix G

TextField.onSetFocus() Event Handler

callback invoked when the field gains focus

Flash 6

theField.onSetFocus(oldFocus)

Arguments

oldFocus The TextField, MovieClip,orButton object that previously had focus, or null

if no object was previously focused.

Description

The onSetFocus() event is triggered when theField gains focus. A text field is said to have

focus when it contains the text insertion point or when characters within it are selected. A

field gains focus when:

• The user clicks it with the mouse or navigates to it with the Tab key.

• Selection.setFocus() assigns focus programmatically.

When a text field’s

selectable property is false, the field cannot be focused by the user,

but it can be focused programmatically with Selection.setFocus().

The following code registers a callback function that responds to ...