User Guide

Global Properties 115
To specify settings that correspond to the Tab index setting in the Accessibility panel, use the
Button.tabIndex, MovieClip.tabIndex, or TextField.tabIndex properties.
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();
If you don't specify an accessibility property for a document or an object, any values set in the
Accessibility panel are implemented.