isActive (Accessibility.isActive method)

public static isActive() : Boolean

Indicates whether an accessibility aid is currently active and the player is communicating with it. Use this method when you want your application to behave differently in the presence of a screen reader or other accessibility aid.

Note: If you call this method within one or two seconds of the first appearance of the Flash window in which your document is playing, you might get a return value of false even if there is an active Microsoft Active Accessibility (MSAA) client. This is because of an asynchronous communication mechanism between Flash and MSAA clients. You can work around this limitation by ensuring a delay of one to two seconds after loading your document before calling this method.

Availability: ActionScript 1.0; Flash Player 6

Returns

Boolean - A Boolean value: true if the Flash Player is communicating with an accessibility aid (usually a screen reader); false otherwise.

Example

The following example checks whether an accessibility aid is currently active:

if (Accessibility.isActive()) {
    trace ("An accessibility aid is currently active");
} else {
    trace ("There is currently no active accessibility aid");
}

See also

updateProperties (Accessibility.updateProperties method), _accProps property, hasAccessibility (capabilities.hasAccessibility property)


Version 8

 

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/8/main/00001895.html