Selection.getfocus() - MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Reference

Selection.getFocus()

Availability
Flash Player 5. Instance names for buttons and text fields work in Flash Player 6 and later.
Usage
Selection.getFocus() : String
Parameters
None.
Returns
A string or
null
Description
Method; returns a string specifying the target path of the object that has focus.
•
If a TextField object has focus, and the object has an instance name, this method returns the
target path of the TextField object. Otherwise, it returns the TextField's variable name.
•
If a Button object or button movie clip has focus, this method returns the target path of the
Button object or button movie clip.
•
If neither a TextField object, Button object, Component instance, nor button movie clip has
focus, this method returns
Example
The following example displays the currently focused selection's target path in a TextArea
component instance. Add several component instances or button, text field and movie clip
instances to the Stage. Then add the following ActionScript to your AS or FLA file.
var focus_ta:mx.controls.TextArea;
my_mc.onRelease = function() {};
my_btn.onRelease = function() {};
var keyListener:Object = new Object();
keyListener.onKeyDown = function() {
if (Key.isDown(Key.SPACE)) {
focus_ta.text = Selection.getFocus()+newline+focus_ta.text;
}
};
Key.addListener(keyListener);
Test the SWF file, and use Tab to move between the instances on the Stage. Make sure you have
Control > Disable Keyboard Shortcuts selected in the test environment.
See also
Selection.onSetFocus,
720 Chapter 2: ActionScript Language Reference
.
.
null
Selection.setFocus()