Pakket | flash.accessibility |
Klasse | public class AccessibilityProperties |
Overerving | AccessibilityProperties Object |
Subklassen | UIComponentAccImpl, UIComponentAccProps |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
U kunt een object AccessibilityProperties aan elk weergaveobject koppelen, maar Flash Player leest uw object AccessibilityProperties alleen voor een bepaald soort objecten: volledige SWF-bestanden (zoals vertegenwoordigd door DisplayObject.root
), containerobjecten (DisplayObjectContainer
en subklassen), knoppen (SimpleButton
en subklassen) en tekst (TextField
en subklassen).
De eigenschap name
van deze objecten is de belangrijkste eigenschap die moet worden opgegeven, omdat toegankelijkheidshulpmiddelen de namen van objecten aan gebruikers opgeven als navigatiemiddel. Verwar AccessibilityProperties.name
niet met DisplayObject.name
; deze zijn verschillend en niet gerelateerd. De eigenschap AccessibilityProperties.name
is een naam die hardop wordt gelezen door toegankelijkheidshulpmiddelen, terwijl DisplayObject.name
voornamelijk een variabelenaam is, die alleen zichtbaar is voor ActionScript-code.
In Flash Professional overschrijven de eigenschappen van AccessibilityProperties
-objecten de overeenkomstige instellingen die beschikbaar zijn in het deelvenster Toegankelijkheid tijdens het ontwerpen.
Wanneer u wilt nagaan of Flash Player wordt uitgevoerd in een omgeving die toegankelijkheidshulpmiddelen ondersteunt, gebruikt u de eigenschap Capabilities.hasAccessibility
. Wanneer u de objecten AccessibilityProperties wijzigt, moet u de methode Accessibility.updateProperties()
aanroepen voordat de wijzigingen effect hebben.
Verwante API-elementen
flash.display.DisplayObject.accessibilityProperties
flash.display.InteractiveObject.tabIndex
flash.system.Capabilities.hasAccessibility
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
description : String
Hiermee wordt een beschrijving voor dit weergaveobject in de toegankelijke presentatie geboden. | AccessibilityProperties | ||
forceSimple : Boolean
Indien true, worden door Flash Player onderliggende objecten binnen dit weergaveobject van de toegankelijke presentatie uitgesloten. | AccessibilityProperties | ||
name : String
Hiermee wordt een naam voor dit weergaveobject in de toegankelijke presentatie geboden. | AccessibilityProperties | ||
noAutoLabeling : Boolean
Indien true, wordt het standaardsysteem voor automatische labels van Flash Player uitgeschakeld. | AccessibilityProperties | ||
shortcut : String
Hiermee wordt een sneltoets aangegeven die aan dit weergaveobject is gekoppeld. | AccessibilityProperties | ||
silent : Boolean
Indien true, wordt dit weergaveobject van de toegankelijke presentatie uitgesloten. | AccessibilityProperties |
Methode | Gedefinieerd door | ||
---|---|---|---|
Hiermee wordt een nieuw object AccessibilityProperties gemaakt. | AccessibilityProperties | ||
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 | ||
Retourneert de primitieve waarde van het opgegeven object. | Object |
description | eigenschap |
public var description:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Hiermee wordt een beschrijving voor dit weergaveobject in de toegankelijke presentatie geboden. Wanneer u veel informatie over het object wilt weergeven, kunt u het best een beknopte naam kiezen en de meeste inhoud in de eigenschap description
plaatsen. Is van toepassing op gehele SWF-bestanden, containers, knoppen en tekst. De standaardwaarde is een lege tekenreeks.
In Flash Professional komt deze eigenschap overeen met het veld Beschrijving in het deelvenster Toegankelijkheid.
forceSimple | eigenschap |
public var forceSimple:Boolean
Runtimeversies: | AIR 1.0, Flash Player 9 |
Indien true
, worden door Flash Player onderliggende objecten binnen dit weergaveobject van de toegankelijke presentatie uitgesloten. De standaardwaarde is false
. Is van toepassing op gehele SWF-bestanden en containers.
name | eigenschap |
public var name:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Hiermee wordt een naam voor dit weergaveobject in de toegankelijke presentatie geboden. Is van toepassing op gehele SWF-bestanden, containers, knoppen en tekst. Verwar dit niet met de eigenschap DisplayObject.name
, deze zijn niet gerelateerd. De standaardwaarde is een lege tekenreeks.
In Flash Professional komt deze eigenschap overeen met het veld Naam in het deelvenster Toegankelijkheid.
noAutoLabeling | eigenschap |
public var noAutoLabeling:Boolean
Runtimeversies: | AIR 1.0, Flash Player 9 |
Indien true
, wordt het standaardsysteem voor automatische labels van Flash Player uitgeschakeld. Automatische labels zorgen dat tekstobjecten binnen knoppen worden beschouwd als knopnamen en tekstobjecten bij tekstvelden worden beschouwd als tekstveldnamen. De standaardwaarde is false
. Is alleen van toepassing op gehele SWF-bestanden.
De waarde van de eigenschap noAutoLabeling
wordt genegeerd tenzij u het opgeeft voordat een toegankelijkheidshulpmiddel voor de eerste keer uw SWF-bestand controleert. Als u noAutoLabeling
op true
wilt instellen, moet u dit zo vroeg mogelijk in de code doen.
shortcut | eigenschap |
public var shortcut:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Hiermee wordt een sneltoets aangegeven die aan dit weergaveobject is gekoppeld. Geef deze tekenreeks alleen op voor UI-besturingselementen die u aan een sneltoets hebt gekoppeld. Is van toepassing op containers, knoppen en tekst. De standaardwaarde is een lege tekenreeks.
Opmerking: het toewijzen van deze eigenschap wijst niet automatisch de opgegeven toetscombinatie aan dit object toe; dat moet u zelf doen, bijvoorbeeld door te luisteren naar een KeyboardEvent
.
De syntaxis voor deze tekenreeks gebruikt lange namen voor wijzigingstoetsen en gebruikt het plusteken (+) om toetscombinaties aan te geven. Voorbeelden van geldige tekenreeksen zijn 'Ctrl+F', 'Ctrl+Shift+Z', enzovoort.
silent | eigenschap |
public var silent:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Indien true
, wordt dit weergaveobject van de toegankelijke presentatie uitgesloten. De standaardwaarde is false
. Is van toepassing op gehele SWF-bestanden, containers, knoppen en tekst.
AccessibilityProperties | () | Constructor |
public function AccessibilityProperties()
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9 |
Hiermee wordt een nieuw object AccessibilityProperties gemaakt.
AccessibilityExample
, CustomAccessibleButton
, CustomSimpleButton
en ButtonDisplayState
gebruikt om een menu te maken dat voldoet aan toegankelijkheidsvereisten en met de meeste schermlezers werkt. De hoofdfunctionaliteit van de klasse AccessibilityProperties
is als volgt:
- Roep
configureAssets
aan, dat een aangepaste knop maakt en het label en de beschrijving ervan instelt. Dit zijn de waarden die de schermlezer overbrengt naar de eindgebruiker. - Roep
setTimeOut()
aan om te zorgen dat Flash Player genoeg tijd heeft om de schermlezer te detecteren voordat de eigenschappen worden bijgewerkt.
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 AccessibilityPropertiesExample 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 AccessibilityPropertiesExample() { 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 label1:TextField; private var description:String; private var _name:String; public function CustomAccessibleButton(_width:uint = 0, _height:uint = 0) { _width = (_width == 0) ? AccessibilityPropertiesExample.BUTTON_WIDTH : _width; _height = (_height == 0) ? AccessibilityPropertiesExample.BUTTON_HEIGHT : _height; button = buildButton(_width, _height); label1 = buildLabel(_width, _height); addEventListener(Event.ADDED, addedHandler); } private function addedHandler(event:Event):void { trace("addedHandler: " + 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 { label1.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