getFocus (Selection.getFocus method)

public static getFocus() : String

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 null.

Availability: ActionScript 1.0; Flash Player 5 - Instance names for buttons and text fields work in Flash Player 6 and later.

Returns

String - A string or null.

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. Add several component instances or button, text field and movie clip instances to your SWF file. 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.

getFocus (Selection.getFocus method)

Returns

Example

See also