Selection.setfocus() - MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Reference

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":String)
Parameters
instanceName
Returns
A Boolean value;
Description
Method; gives focus to the selectable (editable) text field, button, or movie clip specified by
. The
instanceName
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 is passed, the current focus is removed.
null
Example
In the following example, the text field focuses on the
in a browser window. If the user does not fill in one of the required text fields (
), the cursor automatically focuses in the text field that's missing data. For example,
password_txt
if the user does not type anything into the
an error message appears and the cursor focuses in the
this.createTextField("status_txt", this.getNextHighestDepth(), 100, 70, 100,
22);
this.createTextField("username_txt", this.getNextHighestDepth(), 100, 100,
100, 22);
this.createTextField("password_txt", this.getNextHighestDepth(), 100, 130,
100, 22);
this.createEmptyMovieClip("submit_mc", this.getNextHighestDepth());
submit_mc.createTextField("submit_txt", this.getNextHighestDepth(), 100, 160,
100, 22);
submit_mc.submit_txt.autoSize = "center";
submit_mc.submit_txt.text = "Submit";
submit_mc.submit_txt.border = true;
submit_mc.onRelease = checkForm;
username_txt.border = true;
password_txt.border = true;
username_txt.type = "input";
password_txt.type = "input";
password_txt.password = true;
Selection.setFocus("username_txt");
//
function checkForm():Boolean {
if (username_txt.text.length == 0) {
724 Chapter 2: ActionScript Language Reference
A string specifying the path to a button, movie clip, or text field instance.
if the focus attempt is successful,
true
parameter must be a string literal of the path to the instance.
instanceName
if it fails.
false
username_txt
text field and clicks the submit button,
username_txt
username_txt
text field when it is running
username_txt
text field.
and