MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT - Page 612

612 Chapter 12: ActionScript Dictionary
Selection.setFocus()
Availability
Flash Player 5. Instance names for buttons and movie clips work only in Flash Player 6 and later.
Usage
Selection.setFocus("instanceName")
Parameters
instanceName
A string specifying the path to the instance name of a button, movie clip, or
text field.
Returns
An event.
Description
Method; gives focus to the selectable (editable) text field, button, or movie clip specified by
instanceName. The instanceName parameter must be a string literal of the path to the instance.
You can use dot or slash notation to specify the path. You can also use a relative or absolute path.
If you are using ActionScript 2.0, you must use dot notation.
If
null is passed, the current focus is removed.
Example
The following example gives focus to a text field associated with myVar, on the main Timeline.
Because the
instanceName parameter is an absolute path, you can call the action from
any Timeline.
Selection.setFocus("_root.myVar");
In the following example, the text field associated with myVar is in a movie clip called myClip on
the main Timeline. You can use either of the following two paths to set focus; the first is relative
and the second is absolute.
Selection.setFocus("myClip.myVar");
Selection.setFocus("_root.myClip.myVar");
Selection.setSelection()
Availability
Flash Player 5.
Usage
Selection.setSelection(start, end)
Parameters
start
The beginning index of the selection span.
end The ending index of the selection span.