Setfocus (Selection.setfocus Method) - MACROMEDIA FLASH 8-FLASH LITE 2.X ACTIONSCRIPT LANGUAGE Reference

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
parameter. You can use dot or slash notation to specify the path. You can also use a
newFocus
relative or absolute path. If you are using ActionScript 2.0, you must use dot notation.
If is passed, the current focus is removed.
null
Availability: ActionScript 1.0; Flash Lite 2.0
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.
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");
//
if the focus attempt is successful,
true
), the cursor automatically focuses in the text field thats
password_txt
if it fails.
false
text field when it is
username_txt
username_txt
text
Selection 581