Pacchettoflash.accessibility
Classepublic final class Accessibility
EreditarietàAccessibility Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La classe Accessibility gestisce la comunicazione con gli screen reader. Gli screen reader sono un tipo di tecnologia di supporto in grado di fornire agli utenti ipovedenti una versione audio del contenuto delle schermate. I metodi della classe Accessibility sono statici; questo significa che non è necessario creare un'istanza della classe per utilizzarne i metodi.

Per ottenere e impostare le proprietà accessibili di un oggetto specifico (ad esempio un pulsante, un filmato o un campo di testo), utilizzare la proprietà DisplayObject.accessibilityProperties. Per determinare se il lettore viene eseguito in un ambiente che supporta gli strumenti di accessibilità, utilizzare la proprietà Capabilities.hasAccessibility.

Vedere gli esempi

Vedere anche

flash.display.DisplayObject.accessibilityProperties
flash.system.Capabilities.hasAccessibility
Socket


Proprietà pubbliche
 ProprietàDefinito da
  active: Boolean
[statico] [sola lettura] Indica se uno screen reader è attualmente attivo e se sta comunicando con il lettore.
Accessibility
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
Metodi pubblici
 MetodoDefinito da
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
  
[statico] Indica a Flash Player di applicare qualunque modifica di accessibilità apportata utilizzando la proprietà DisplayObject.accessibilityProperties.
Accessibility
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà
activeproprietà
active:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se uno screen reader è attualmente attivo e se sta comunicando con il lettore. Utilizzare questo metodo quando si desidera che l'applicazione si comporti in modo diverso in presenza di uno screen reader.

Nota: se si chiama questo metodo entro uno o due secondi dall'apertura della finestra di Flash® in cui viene riprodotto il documento, è possibile che venga restituito un valore false anche se è attivo un client di accessibilità. Questo inconveniente è causato dal meccanismo di comunicazione asincrono tra Flash e i client di accessibilità. Questa limitazione può essere risolta chiamando il metodo 1 o 2 secondi dopo il caricamento del documento.

Per determinare se il lettore viene eseguito in un ambiente che supporta gli screen reader, utilizzare la proprietà Capabilities.hasAccessibility.


Implementazione
    public static function get active():Boolean

Vedere anche

Descrizione dei metodi
updateProperties()metodo
public static function updateProperties():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica a Flash Player di applicare qualsiasi modifica di accessibilità utilizzando la proprietà DisplayObject.accessibilityProperties. Affinché le modifiche abbiano effetto, è necessario chiamare questo metodo.

Se si modificano le proprietà di accessibilità di più oggetti, è necessaria una sola chiamata al metodo Accessibility.updateProperties(); più chiamate possono infatti influire negativamente sulle prestazioni e sui risultati degli screen reader.


Genera
IllegalOperationError — La classe Accessibility non è supportata in questa versione di Flash Player. Non chiamare il metodo Accessibility.updateProperties() se la proprietà flash.system.Capabilities.hasAccessibility è false.

Vedere anche

Esempi Come utilizzare gli esempi
AccessibilityExample.as

L'esempio seguente utilizza le classi di esempio AccessibilityExample, CustomAccessibleButton, CustomSimpleButton e ButtonDisplayState per creare un menu conforme all'accessibilità che funzioni con la maggior parte degli screen reader. L'esempio esegue le operazioni seguenti:
  1. Traccia la proprietà Accessibility.active per determinare se uno screen reader è attualmente attivo e se sta comunicando con il lettore.
  2. Se la proprietà active restituisce true, l'esempio chiama il metodo updateProperties() per applicare le modifiche all'accessibilità apportate ai pulsanti nell'esempio.
  3. L'esempio chiama il metodo flash.utils.setTimeout(), specificando che il metodo di chiusura updateAccessibility() deve essere chiamato dopo 2 secondi.

Nota: chiamare setTimeout() prima di verificare Accessibility.active per lasciare a Flash Player i 2 secondi necessari per connettersi a uno screen reader, se disponibile. Se non si fornisce un ritardo sufficiente, la chiamata a setTimeout potrebbe restituire false anche se è disponibile uno screen reader.

L'esempio seguente elabora il metodo Accessibility.updateProperties() solo se la chiamata a Accessibility.active restituisce true, il che accade solo se Flash Player è attualmente connesso a uno screen reader attivo. Se viene chiamato updateProperties senza uno screen reader attivo, viene generata un'eccezione IllegalOperationError.

package {
    import flash.display.Sprite;
    import flash.accessibility.Accessibility;
    import flash.utils.setTimeout;
    
    public class AccessibilityExample extends Sprite {
        public static const BUTTON_WIDTH:uint = 90;
        public static const BUTTON_HEIGHT:uint = 20;
        
        private var gutter:uint = 5;
        private var menuLabels:Array = new Array("PROJECTS", "PORTFOLIO", "CONTACT");
        private var menuDescriptions:Array = new Array("Learn more about our projects"
                                                     , "See our portfolio"
                                                     , "Get in touch with our team");
        
        public function AccessibilityExample() {
            configureAssets();
            setTimeout(updateAccessibility, 2000); 
        }
        
        private function updateAccessibility():void {
            trace("Accessibility.active: " + Accessibility.active);
            if(Accessibility.active) {
                Accessibility.updateProperties();
            }
        }
        
        private function configureAssets():void {
            var child:CustomAccessibleButton;
            for(var i:uint; i < menuLabels.length; i++) {
                child = new CustomAccessibleButton();
                child.y = (numChildren * (BUTTON_HEIGHT + gutter));
                child.setLabel(menuLabels[i]);
                child.setDescription(menuDescriptions[i]);
                addChild(child);
            }
        }
    }
}
    
import flash.accessibility.AccessibilityProperties;
import flash.display.Shape;
import flash.display.SimpleButton;
import flash.display.Sprite;
import flash.events.Event;
import flash.text.TextFormat;
import flash.text.TextField;


class CustomAccessibleButton extends Sprite {
    private var button:SimpleButton;
    private var label:TextField;
    private var description:String;
    private var _name:String;
        
    public function CustomAccessibleButton(_width:uint = 0, _height:uint = 0) {
        _width = (_width == 0) ? AccessibilityExample.BUTTON_WIDTH : _width;
        _height = (_height == 0) ? AccessibilityExample.BUTTON_HEIGHT : _height;
        
        button = buildButton(_width, _height);
        label = buildLabel(_width, _height);
            
        addEventListener(Event.ADDED, addedHandler);
    }
        
    private function addedHandler(event:Event):void {
        trace("addedHandler: " + this._name);
        var accessProps:AccessibilityProperties = new AccessibilityProperties();
        accessProps.name = this._name;
        accessProps.description = description;
        accessibilityProperties = accessProps;
        removeEventListener(Event.ADDED, addedHandler);
    }
        
    private function buildButton(_width:uint, _height:uint):SimpleButton {
        var child:SimpleButton = new CustomSimpleButton(_width, _height);
        addChild(child);
        return child;
    }

    private function buildLabel(_width:uint, _height:uint):TextField {
        var format:TextFormat = new TextFormat();
        format.font = "Verdana";
        format.size = 11;
        format.color = 0xFFFFFF;
        format.align = TextFormatAlign.CENTER;
        format.bold = true;
        
        var child:TextField = new TextField();
        child.y = 1;
        child.width = _width;
        child.height = _height;
        child.selectable = false;
        child.defaultTextFormat = format;
        child.mouseEnabled = false;
            
        addChild(child);
        return child;
    }
        
    public function setLabel(text:String):void {
        label.text = text;
        this._name = text;
    }
        
    public function setDescription(text:String):void {
        description = text;
    }
}
    
class CustomSimpleButton extends SimpleButton {
    private var upColor:uint = 0xFFCC00;
    private var overColor:uint = 0xCCFF00;
    private var downColor:uint = 0x00CCFF;

    public function CustomSimpleButton(_width:uint, _height:uint) {
        downState = new ButtonDisplayState(downColor, _width, _height);
        overState = new ButtonDisplayState(overColor, _width, _height);
        upState = new ButtonDisplayState(upColor, _width, _height);
        hitTestState = new ButtonDisplayState(upColor, _width, _height);
        useHandCursor = true;
    }        
}

class ButtonDisplayState extends Shape {
    private var bgColor:uint;
    private var _width:uint;
    private var _height:uint;

    public function ButtonDisplayState(bgColor:uint, _width:uint, _height:uint) {
        this.bgColor = bgColor;
        this._width = _width;
        this._height = _height;
        draw();
    }

    private function draw():void {
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, _width, _height);
        graphics.endFill();
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/accessibility/Accessibility.html