MACROMEDIA Flash Lite 2, Reference, Page: 581 / 780

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");
//