User Guide

96 Chapter 2: ActionScript Language Reference
To specify settings that correspond to the Tab index setting in the Accessibility panel, use the
Button.tabIndex, MovieClip.tabIndex, or TextField.tabIndex property.
There is no way to specify an Auto Label setting at runtime.
To refer to the
_accProps object that represents the entire Flash document, omit the
instanceName parameter. The value of _accProps must be an object. This means that if no
_accProps object already exists, you must create one, as shown in the following example, before
you can assign values to the properties of the
_accProps object:
if ( _accProps == undefined ) {
_accProps = new Object();
}
_accProps.name = "My SWF file";
When _accProps is used without the instanceName parameter, changes made to _accProps
properties apply to the whole SWF file. For example, the following code sets the Accessibility
name property for the whole SWF file to the string "Pet Store" and then calls
Accessibility.updateProperties() to cause that change:
_accProps.name = "Pet Store";
Accessibility.updateProperties();
In contrast, the following code sets the name property for a movie clip with the instance name
price_mc to the string "Price":
price_mc._accProps.name = "Price";
Accessibility.updateProperties();
If you are specifying several accessibility properties, make as many changes as you can
before calling
Accessibility.updateProperties(), instead of calling it after each
property statement, as shown in the following example:
_accProps.name = "Pet Store";
animal_mc._accProps.name = "Animal";
animal_mc._accProps.description = "Cat, dog, fish, etc.";
price_mc._accProps.name = "Price";
price_mc._accProps.description = "Cost of a single item";
Accessibility.updateProperties();
description
String Description Whole SWF files
Movie clips
Buttons
Dynamic text
Input text
shortcut
String Shortcut* Movie clips
Buttons
Input text
* For the Shortcut field, use names of the form Control+A. Adding a keyboard shortcut to the Accessibility panel
doesn’t create a keyboard shortcut; it merely advises screen readers of an existing shortcut. For information on
assigning a keyboard shortcut to an accessible object, see Key.addListener().
Property Data type Equivalent in Accessibility panel Applies to