Accessibility.isActive( ) Method

ActionScript for Flash MX: The Definitive Guide, 2nd Edition
By Colin Moock
Chapter 18.  ActionScript Language Reference
Accessibility.isActive( ) Method Flash 6

indicates whether an accessibility aid program (generally a screen reader) is communicating with the Flash Player
Accessibility.isActive()

Returns

A Boolean: true if an accessibility aid is communicating with the Player, or false if not.

Description

The isActive( ) method returns a Boolean indicating whether an external accessibility application, such as a screen reader, is currently being used to read what the Flash Player is displaying. If a screen reader is in use, isActive( ) returns true, otherwise, it returns false.

Not all Flash Players support communication with an accessibility application. To check whether the specific Flash Player running the movie supports accessibility, use capabilities.hasAccessibility. Currently, only the ActiveX version of Flash Player 6 for Windows Internet Explorer supports accessibility. Players that do not support accessibility, including the Netscape plugin for Windows and the Macintosh plugin, always return false for Accessibility.isActive( ).

The isActive( ) method depends on the Flash Player having received an initial communication from an accessibility aid program. There is a small, but not negligible, delay between when the Flash Player starts up and when it receives the first such message. Thus, when isActive( ) is invoked early in a Flash movie, it may return false even though there is actually an accessibility aid running. To work around this problem, build a delay of approximately one second into your movie before calling isActive( ).

See Also

Accessibility.sendEvent( ), capabilities.hasAccessibility

     



    ActionScript for Flash MX. The Definitive Guide
    ActionScript for Flash MX: The Definitive Guide, Second Edition
    ISBN: 059600396X
    EAN: 2147483647
    Year: 2002
    Pages: 780
    Authors: Colin Moock

    flylib.com © 2008-2017.
    If you may any questions please contact us: flylib@qtcs.net