MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE Reference page 1078

Availability: ActionScript 1.0; Flash Player 5 - Instance names for buttons and movie clips
work only in Flash Player 6 and later.
Parameters
- An object such as a button, movie clip or text field instance, or a string
newFocus:Object
specifying the path to a button, movie clip, or text field instance. If you pass a string literal
specifying a path, enclose the path in quotation marks (" "). You can use dot or slash notation
to specify the path. If you are using ActionScript 2.0, you must use dot notation. You can use
a relative or absolute path.
Returns
- A Boolean value;
Boolean
Example
In the following example, the text field focuses on the
running in a browser window. If the user does not fill in one of the required text fields
( and
username_txt
missing data. For example, if the user does not type anything into the
field and clicks the submit button, an error message appears and the cursor focuses in the
text field.
username_txt
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) {
status_txt.text = "fill in username";
Selection.setFocus("username_txt");
1078 ActionScript classes
if the focus attempt is successful,
true
), the cursor automatically focuses in the text field that's
password_txt
if it fails.
false
text field when it is
username_txt
username_txt
text