Button.tabEnabled Property

ActionScript for Flash MX: The Definitive Guide, 2nd Edition
By Colin Moock
Chapter 18.  ActionScript Language Reference
Button.tabEnabled Property Flash 6

Boolean; includes or excludes the button from the current tab order read/write
theButton.tabEnabled

Description

The Boolean tabEnabled property governs whether theButton is part of the tab order for the text fields, movie clips, and buttons currently on screen. The tab order is the sequence in which objects are focused when the Tab key is pressed in a movie. See TextField.tabEnabled for complete details.

For buttons, the tabEnabled property can exclude a button with a defined tabIndex from the custom tab order, or it can exclude any button from the automatic tab order. A button is typically removed from the tab order when it is disabled (its enabled property is false) or when it should be accessible only to mouse input, such as in games that use transparent buttons to act as mouse hit regions.

A movie clip's tabChildren property controls whether the text fields, clips, and buttons it contains are included in the automatic tab order. To disable tabbing for a group of buttons quickly, put them in a movie clip and set its tabChildren to false.

Usage

The Tab key does not work reliably in Test Movie mode unless Control figs/u2192.gif Disable Keyboard Shortcuts is enabled. Be sure to test keyboard behavior in the Standalone Player, if applicable, and in the Flash Player for all targeted web browsers.

Example

The following code prevents the keyboard from accessing done_btn:

done_btn.tabEnabled = false;

See Also

Button.enabled, Button.tabIndex, MovieClip.tabChildren, MovieClip.tabEnabled, TextField.tabEnabled



    ActionScript for Flash MX. The Definitive Guide
    ActionScript for Flash MX: The Definitive Guide, Second Edition
    ISBN: 059600396X
    EAN: 2147483647
    Year: 2002
    Pages: 780
    Authors: Colin Moock

    flylib.com © 2008-2017.
    If you may any questions please contact us: flylib@qtcs.net