User Guide

Selection.setFocus() 677
Returns
A Boolean value; true if the focus attempt is successful, false if it fails.
Description
Method; gives focus to the selectable (editable) text field, button, or movie clip specified by
instanceName. The instancePathName 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. The
instancePathName parameter is a string litereal so it must be enclosed in quotation marks(“”),
but the
instanceName parameter is a reference to an object so it should be used without
quotation marks.
If
null is passed, the current focus is removed.
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 that’s 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");
//
function checkForm():Boolean {
if (username_txt.text.length == 0) {
status_txt.text = "fill in username";
Selection.setFocus("username_txt");
return false;
}
if (password_txt.text.length == 0) {
status_txt.text = "fill in password";
Selection.setFocus("password_txt");
return false;
}