Paqueteflash.accessibility
Clasepublic final class Accessibility
HerenciaAccessibility Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La clase Accessibility gestiona la comunicación con lectores de pantalla. Los lectores de pantalla son un tipo de tecnología auxiliar para usuarios invidentes que ofrece una versión audio del contenido de la pantalla. Los métodos de la clase Accessibility son estáticos, lo que significa que no tiene que crear una instancia de la clase para utilizar sus métodos.

Para obtener y definir las propiedades de un objeto concreto como, por ejemplo, un botón, un clip de película o un campo de texto, utilice la propiedad DisplayObject.accessibilityProperties. Para determinar si el reproductor se está ejecutando en un entorno que admite elementos de accesibilidad, utilice la propiedad Capabilities.hasAccessibility.

Ver los ejemplos

Véase también

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


Propiedades públicas
 PropiedadDefinido por
  active : Boolean
[static] [read-only] Indica si un lector de pantalla está activo actualmente y si el reproductor se comunica con él.
Accessibility
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
Métodos públicos
 MétodoDefinido por
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
  
[static] Indica a Flash Player que aplique todos los cambios de accesibilidad mediante la propiedad DisplayObject.accessibilityProperties.
Accessibility
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Información sobre propiedades
activepropiedad
active:Boolean  [read-only]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Indica si un lector de pantalla está activo actualmente y si el reproductor se comunica con él. Utilice este método cuando desee que la aplicación se comporte de forma diferente en presencia de un lector de pantalla.

Nota: si llama a este método antes de que transcurran 1 ó 2 segundos desde la primera aparición de la ventana de Flash ® en la que se está reproduciendo el documento, es posible que se devuelva el valor false aunque haya activo un cliente de accesibilidad. Esto se debe a que el mecanismo de comunicación entre Flash y los clientes de accesibilidad es asíncrono. Puede evitar esta limitación asegurándose de que se produce un retardo de entre 1 y 2 segundos tras la carga del documento antes de llamar a este método.

Para determinar si el reproductor se está ejecutando en un entorno que admite lectores de pantalla, utilice la propiedad Capabilities.hasAccessibility.


Implementación
    public static function get active():Boolean

Véase también

Información sobre métodos
updateProperties()método
public static function updateProperties():void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Indica a Flash Player que aplique todos los cambios de accesibilidad mediante la propiedad DisplayObject.accessibilityProperties. Es necesario llamar a este método para que los cambios surtan efecto.

Si modifica las propiedades de accesibilidad de varios objetos, sólo será necesaria una llamada al método Accessibility.updateProperties(); si se realizan varias llamadas, podría producirse una reducción del rendimiento y obtenerse datos incorrectos en el lector de pantalla.


Emite
IllegalOperationError — La clase Accessibility no se admite en esta versión de Flash Player. No llame al método Accessibility.updateProperties() si la propiedad flash.system.Capabilities.hasAccessibility es false.

Véase también

Ejemplos Cómo utilizar los ejemplos
AccessibilityExample.as

En los ejemplos siguientes, se utilizan las clases de muestra AccessibilityExample, CustomAccessibleButton, CustomSimpleButton y ButtonDisplayState para crear un menú compatible con la accesibilidad que funcione con la mayor parte de los lectores de pantalla. El ejemplo realiza las siguientes tareas:
  1. Busca la propiedad Accessibility.active para determinar si un lector de pantalla está activo actualmente y si el reproductor se comunica con él.
  2. Si la propiedad active devuelve true, el ejemplo llama al método updateProperties() para aplicar los cambios de accesibilidad realizados en los botones de este ejemplo.
  3. El ejemplo llama al método flash.utils.setTimeout(), especificando que se debe llamar al método de cierre updateAccessibility() transcurridos 2 segundos.

Nota: llame a setTimeout() antes de comprobar Accessibility.active para que Flash Player cuente con los 2 segundos que necesita para conectarse a un lector de pantalla, si hay alguno disponible. Si no se proporciona un tiempo de demora suficiente, la llamada a setTimeout puede devolver false aunque haya un lector disponible.

En el ejemplo siguiente, se procesa el método Accessibility.updateProperties() sólo si la llamada a Accessibility.active devuelve true, lo cual sucede únicamente si Flash Player se encuentra conectado a un lector de pantalla activo. Si se llama a updateProperties sin un lector de pantalla activo, se emitirá una excepción 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();
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/accessibility/Accessibility.html