| Paket | flash.accessibility |
| Klasse | public final class Accessibility |
| Vererbung | Accessibility Object |
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Verwenden Sie die Eigenschaft DisplayObject.accessibilityProperties, um die Eingabehilfeneigenschaften für ein bestimmtes Objekt abzurufen und festzulegen, z. B. für eine Schaltfläche, einen Movieclip oder ein Textfeld. Um zu ermitteln, ob der Player in einer Umgebung ausgeführt wird, die Eingabehilfen unterstützt, verwenden Sie die Eigenschaft Capabilities.hasAccessibility.
Siehe auch
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| active : Boolean
[static] [read-only]
Gibt an, ob derzeit ein Bildschirmleseprogramm aktiv ist und ein Datenaustausch mit dem Player stattfindet.
| Accessibility | ||
![]() | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
| Object | |
![]() | prototype : Object
[static]
Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
| Object | |
| Methode | Definiert von | ||
|---|---|---|---|
![]() |
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
| Object | |
![]() |
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
| Object | |
![]() |
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
| Object | |
![]() |
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
| Object | |
![]() |
Gibt das angegebene Objekt als String zurück.
| Object | |
|
[static]
Weist Flash Player an, alle mithilfe der DisplayObject.accessibilityProperties-Eigenschaft vorgenommenen Änderungen der Eingabehilfeneinstellungen zu übernehmen.
| Accessibility | ||
![]() |
Gibt den Grundwert des angegebenen Objekts zurück.
| Object | |
| active | Eigenschaft |
active:Boolean [read-only]
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt an, ob derzeit ein Bildschirmleseprogramm aktiv ist und ein Datenaustausch mit dem Player stattfindet. Verwenden Sie diese Methode, wenn Sie das Verhalten der Anwendung bei Verwendung eines Bildschirmleseprogramms ändern möchten.
Hinweis: Wenn Sie diese Methode innerhalb der ersten ein bis zwei Sekunden nach dem ersten Öffnen des Flash®-Fensters aufrufen, in dem das Dokument wiedergegeben wird, gibt das System ggf. den Wert false zurück, obwohl ein Eingabehilfen-Client aktiv ist. Der Grund dafür ist die asynchrone Kommunikation zwischen Flash und Eingabehilfen-Clients. Sie können dieses Problem umgehen, indem Sie die Methode erst mit einer Verzögerung von ein bis zwei Sekunden nach dem Laden des Dokuments aufrufen.
Capabilities.hasAccessibility.
public static function get active():Boolean
Siehe auch
| updateProperties | () | Methode |
public static function updateProperties():void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Weist Flash Player an, alle mithilfe der DisplayObject.accessibilityProperties-Eigenschaft vorgenommenen Änderungen der Eingabehilfeneinstellungen zu übernehmen. Sie müssen diese Methode aufrufen, damit die Änderungen wirksam werden.
Wenn Sie die Eingabehilfeneigenschaften für mehrere Objekte ändern, ist nur ein einziger Aufruf der Accessibility.updateProperties()-Methode erforderlich. Mehrere Aufrufe können zu verminderter Leistung und fehlerhaften Ergebnissen der Bildschirmleserausgabe führen.
IllegalOperationError — Eingabehilfen werden in dieser Flash Player-Version nicht unterstützt. Rufen Sie die Accessibility.updateProperties()-Methode nicht auf, wenn die flash.system.Capabilities.hasAccessibility-Eigenschaft auf false gesetzt ist.
|
Siehe auch
AccessibilityExample, CustomAccessibleButton, CustomSimpleButton und ButtonDisplayState ein Menü erstellt, das mit den Eingabehilfen kompatibel ist und mit den meisten Bildschirmleseprogrammen funktioniert. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
Accessibility.active-Eigenschaft, um zu ermitteln, ob derzeit ein Bildschirmleseprogramm aktiv ist und ein Datenaustausch mit dem Player stattfindet.active-Eigenschaft true lautet, ruft das Beispiel die updateProperties()-Methode auf, um die für die Eingabehilfen relevanten Änderungen anzuwenden, die in diesem Beispiel an den Schaltflächen vorgenommen wurden.flash.utils.setTimeout()-Methode auf und gibt an, dass die updateAccessibility()-Abschlussmethode nach zwei Sekunden aufgerufen werden soll.Hinweis: Rufen Sie setTimeout() auf, bevor Sie Accessibility.active aktivieren, um Flash Player die zwei Sekunden zu geben, die die Anwendung zum Herstellen der Verbindung zu einem Bildschirmleseprogramm benötigt (falls vorhanden). Wenn Sie keine ausreichende Zeitverzögerung angeben, wird beim Aufrufen von setTimeout ggf. auch dann false zurückgegeben, wenn ein Bildschirmleseprogramm verfügbar ist.
Das folgende Beispiel verarbeitet die Accessibility.updateProperties()-Methode nur, wenn beim Aufrufen von Accessibility.active der Wert true zurückgegeben wird. Dies ist nur der Fall, wenn Flash Player gerade über eine Verbindung zu einem aktiven Bildschirmleseprogramm verfügt. Wenn Sie updateProperties aufrufen, ohne dass ein Bildschirmleseprogramm aktiv ist, wird eine IllegalOperationError-Ausnahme ausgelöst.
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();
}
}
Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht
Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/accessibility/Accessibility.html