Pakket | flash.accessibility |
Klasse | public final class Accessibility |
Overerving | Accessibility Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Mobielebrowserondersteuning: Mobiele browsers bieden geen ondersteuning voor deze klasse.
AIR-profielondersteuning: deze functie wordt ondersteund op alle desktopbesturingssystemen, maar niet op mobiele apparaten en ook niet op AIR for TV-apparaten. Zie AIR-profielondersteuning voor meer informatie over API-ondersteuning voor meerdere profielen.
Gebruik de eigenschap DisplayObject.accessibilityProperties
om de toegankelijke eigenschappen voor een specifiek object, zoals een knop, filmclip of tekstveld, op te halen en in te stellen. Wanneer u wilt nagaan of de speler of de runtime wordt uitgevoerd in een omgeving die toegankelijkheidshulpmiddelen ondersteunt, gebruikt u de eigenschap Capabilities.hasAccessibility
.
Opmerking: AIR 2 ondersteunt de schermlezersoftware van JAWS 11 (of hoger). Zie voor meer informatie http://www.adobe.com/nl/accessibility/.
Meer informatie
Verwante API-elementen
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
active : Boolean [statisch] [alleen-lezen]
Hiermee wordt aangegeven of een schermlezer actief is en de toepassing ermee communiceert. | Accessibility | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object |
Methode | Gedefinieerd door | ||
---|---|---|---|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
[statisch]
Hiermee wordt aan Flash Player doorgegeven dat eventuele toegankelijkheidswijzigingen moeten worden toegepast die met de eigenschap DisplayObject.accessibilityProperties zijn gemaakt. | Accessibility | ||
Retourneert de primitieve waarde van het opgegeven object. | Object |
active | eigenschap |
active:Boolean
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Hiermee wordt aangegeven of een schermlezer actief is en de toepassing ermee communiceert. Gebruik deze methode als u wilt dat de toepassing zich anders gedraagt wanneer een schermlezer beschikbaar is.
Wanneer deze eigenschap op true
is ingesteld, blijft deze true
voor de rest van de toepassingsduur. (Het is ongebruikelijk dat een gebruiker de schermlezer na het starten uitschakelt.)
Opmerking:voordat u deze methode oproept, wacht u 1 of 2 seconden na het opstarten van uw AIR-toepassing of na het eerste verschijnen van het Flash® Player-venster waarin uw document wordt afgespeeld. Anders krijgt u misschien een retourwaarde false
, zelfs als er een actieve toegankelijkheidsclient is. Dit gebeurt als gevolg van een asynchroon communicatiemechanisme tussen toegankelijkheidclients en Flash Player of AIR.
Capabilities.hasAccessibility
.
Implementatie
public static function get active():Boolean
Verwante API-elementen
updateProperties | () | methode |
public static function updateProperties():void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Hiermee wordt aan Flash Player doorgegeven dat eventuele toegankelijkheidswijzigingen moeten worden toegepast die met de eigenschap DisplayObject.accessibilityProperties
zijn gemaakt. U moet deze methode aanroepen voordat de wijzigingen effect hebben.
Wanneer u de toegankelijkheidseigenschappen van meerdere objecten wijzigt, is slechts een enkele aanroep van Accessibility.updateProperties()
nodig; meerdere aanroepen kunnen resulteren in verminderde prestaties en onbegrijpelijke schermlezerresultaten.
Gegenereerde uitzondering
IllegalOperationError — Accessibility wordt niet ondersteund in deze versie van Flash Player. Roep de methode Accessibility.updateProperties() niet aan als de eigenschap flash.system.Capabilities.hasAccessibility op false is ingesteld.
|
Verwante API-elementen
AccessibilityExample
, CustomAccessibleButton
, CustomSimpleButton
en ButtonDisplayState
gebruikt om een menu te maken dat voldoet aan toegankelijkheidsvereisten en met de meeste schermlezers werkt. In het voorbeeld worden de volgende taken uitgevoerd:
- De eigenschap
Accessibility.active
wordt getraceerd om te bepalen of momenteel een schermlezer actief is en de speler ermee communiceert. - Wanneer de eigenschap
active
true
retourneert, roept het voorbeeld de methodeupdateProperties()
aan om wijzigingen voor de toegankelijkheid uit te voeren die in dit voorbeeld op de knoppen zijn toegepast. - In het voorbeeld wordt de methode
flash.utils.setTimeout()
aangeroepen, die opgeeft dat de closure-methodeupdateAccessibility()
na twee seconden moet worden aangeroepen.
Opmerking: roep setTimeout()
aan voordat u Accessibility.active
controleert om Flash Player de twee seconden te geven die nodig zijn om verbinding te maken met een schermlezer, als die beschikbaar is. Wanneer u niet voldoende vertragingstijd biedt, kan de aanroep setTimeout
false
retourneren, zelfs als een schermlezer beschikbaar is.
In het volgende voorbeeld wordt de methode Accessibility.updateProperties()
alleen verwerkt als de aanroep van Accessibility.active
true
retourneert. Dit gebeurt alleen als Flash Player momenteel verbonden is met een actieve schermlezer. Wanneer updateProperties
wordt aangeroepen zonder een actieve schermlezer, wordt een uitzondering IllegalOperationError
gegenereerd.
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(); } }
Wed Jun 13 2018, 11:42 AM Z