, _accProps, System.capabilities.hasAccessibilityAccessibility.updateProperties(), _accProps, System.capabilities.hasAccessibilityAccessibility.updateProperties()

Availability

Flash Player 7.

Usage

Accessibility.updateProperties()

Parameters

None.

Returns

Nothing.

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. You can apply accessibility properties to the movie as a whole or to a specific movie clip, and you can set them during authoring using the Accesibility panel, and at runtime using the global variable _accProps.

When you update the accessibility properties for multiple objects at once, only a single call to Accessibility.updateProperties() is necessary; multiple calls can result in reduced performance, as well as causing the screen reader to "babble."

Example

The following ActionScript code takes advantage of dynamic accessibility properties. This hypothetical code is from a nontextual icon button component 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