| 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
configureAssetsaan, 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
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergeven