User Guide

Selection 581
setFocus (Selection.setFocus method)
public static setFocus(newFocus:Object) : Boolean
Gives focus to the selectable (editable) text field, button, or movie clip, specified by the
newFocus parameter. 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.
Availability: ActionScript 1.0; Flash Lite 2.0
Parameters
newFocus:Object - An object such as a button, movie clip or text field instance, or a string
specifying the path to a button, movie clip, or text field instance.
Returns
Boolean - A Boolean value; true if the focus attempt is successful, false if it fails.
Example
In the following example, the text field focuses on the username_txt text field when it is
running in a browser window. If the user does not fill in one of the required text fields
(
username_txt and password_txt), the cursor automatically focuses in the text field thats
missing data. For example, if the user does not type anything into the
username_txt text
field and clicks the submit button, an error message appears and the cursor focuses in the
username_txt text field.
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");
//