268 Chapter 12: ActionScript Dictionary
Description
Method; causes Flash Player to reexamine all accessibility properties, update its description of
objects for screen readers, and, if necessary, send events to screen readers to indicate that changes
have occurred. For information on setting accessibility properties, see _accProps.
To determine whether the player is running in an environment that supports accessibility aids, use
System.capabilities.hasAccessibility.
If you modify the accessibility properties for multiple objects, only one call to
Accessibility.updateProperties() is necessary; multiple calls can result in reduced
performance and unintelligible screen reader results.
Example
The following ActionScript code takes advantage of dynamic accessibility properties. This
example is from a nontextual button that can change which icon it displays.
function setIcon( newIconNum, newTextEquivalent )
{
this.iconImage = this.iconImages[ newIconNum ];
if ( newTextEquivalent != undefined )
{
if ( this._accProps == undefined )
this._accProps = new Object();
this._accProps.name = newTextEquivalent;
Accessibility.updateProperties();
}
}
See also
Accessibility.isActive()
, _accProps, System.capabilities.hasAccessibility
_accProps
Availability
Flash Player 6 version 65.
Usage
_accProps.propertyName
instanceName._accProps.propertyName
Parameters
propertyName
An accessibility property name (see the following description for valid names).
instanceName The instance name assigned to an instance of a movie clip, button, dynamic text
field, or input text field.
Description
Property; lets you control screen reader accessibility options for SWF files, movie clips, buttons,
dynamic text fields, and input text fields at runtime. These properties override the corresponding
settings available in the Accessibility panel during authoring. For changes to these properties to
take effect, you must call
Accessibility.updateProperties(). For information on the
Accessibility panel, see “Introducing the Flash Accessibility panel” in Using Flash Help.
To Next Page
Loading...