MACROMEDIA FLEX-FLEX ACTIONSCRIPT LANGUAGE Reference page 677

Returns
A Boolean value;
true
Description
Method; gives focus to the selectable (editable) text field, button, or movie clip specified by
. The
instanceName
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
but the
instanceName
quotation marks.
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) {
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;
}
if the focus attempt is successful,
parameter must be a string literal of the path to the
instancePathName
parameter is a string litereal so it must be enclosed in quotation marks(""),
parameter is a reference to an object so it should be used without
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.
Selection.setFocus()
and
677