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;
}
Summary of Contents for FLEX-FLEX ACTIONSCRIPT LANGUAGE
Page 1: ...Flex ActionScript Language Reference...
Page 8: ......
Page 66: ...66 Chapter 2 Creating Custom Classes with ActionScript 2 0...
Page 76: ......
Page 133: ...break 133 See also for for in do while while switch case continue throw try catch finally...
Page 135: ...case 135 See also break default strict equality switch...
Page 146: ...146 Chapter 5 ActionScript Core Language Elements See also break continue while...
Page 808: ...808 Chapter 7 ActionScript for Flash...
Page 810: ...810 Appendix A Deprecated Flash 4 operators...
Page 815: ...Other keys 815 Num Lock 144 186 187 _ 189 191 192 219 220 221 222 Key Key code...
Page 816: ...816 Appendix B Keyboard Keys and Key Code Values...
Page 822: ...822 Index...