MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE, Reference

Page: 115 / 1378

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.