Paket | flash.accessibility |
Klass | public final class Accessibility |
Arv | Accessibility Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Stöd för mobilwebbläsare: Den här klassen stöds inte i mobilwebbläsare.
Stöd för AIR-profiler: Den här funktionen stöds på alla operativsystem för datorer, men inte på mobilenheter eller enheter med AIR for TV. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.
Om du vill hämta och ange hjälpmedelsegenskaper för ett visst objekt, till exempel en knapp, ett filmklipp eller ett textfält använder du egenskapen DisplayObject.accessibilityProperties
. Om du vill ta reda på om spelaren eller miljön körs i en miljö som kan hantera hjälpmedelsfunktioner använder du egenskapen Capabilities.hasAccessibility
.
Obs! I AIR 2 finns stöd för skärmläsarprogrammet JAWS 11 (eller senare). Mer information finns på http://www.adobe.com/se/accessibility/.
Lär dig mer
Relaterade API-element
Egenskap | Definieras med | ||
---|---|---|---|
active : Boolean [statisk] [skrivskyddad]
Anger om en skärmläsare är aktiv och kommunicerar med programmet. | Accessibility | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object |
Metod | Definieras med | ||
---|---|---|---|
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
Returnerar det angivna objektets strängbeteckning. | Object | ||
[statisk]
Instruerar Flash Player att tillämpa alla hjälpmedelsändringar som gjorts med egenskapen DisplayObject.accessibilityProperties. | Accessibility | ||
Returnerar det angivna objektets primitiva värde. | Object |
active | egenskap |
active:Boolean
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Anger om en skärmläsare är aktiv och kommunicerar med programmet. Använd den här metoden om du vill att programmet ska fungera annorlunda när en skärmläsare används.
När den här egenskapen har angetts som true
förblir den true
under hela programmet. (Det är ovanligt att användaren stänger av skärmläsaren när den väl har startats.)
Obs! Innan du anropar den här metoden väntar du en eller två sekunder efter att du startat AIR-programmet eller efter att Flash® Player-fönstret, som dokumentet spelas upp i, först visas. Annars kan returvärdet bli false
, trots att det finns en aktiv hjälpmedelsklient. Detta inträffar på grund av en asynkron kommunikationsfunktion mellan hjälpmedelsklienter och Flash Player eller AIR.
Capabilities.hasAccessibility
.
Implementering
public static function get active():Boolean
Relaterade API-element
updateProperties | () | metod |
public static function updateProperties():void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Instruerar Flash Player att tillämpa alla hjälpmedelsändringar som gjorts med egenskapen DisplayObject.accessibilityProperties
. Du måste anropa den här metoden för att ändringarna ska börja gälla.
Om du ändrar hjälpmedelsegenskaperna för flera objekt räcker det med ett anrop till Accessibility.updateProperties()
. Flera anrop kan resultera i sämre prestanda och felaktiga skärmläsarresultat.
Utlöser
IllegalOperationError — Hjälpmedel stöds inte i den här versionen av Flash Player. Anropa inte Accessibility.updateProperties() -metoden om egenskapen flash.system.Capabilities.hasAccessibility är false .
|
Relaterade API-element
AccessibilityExample
, CustomAccessibleButton
, CustomSimpleButton
och ButtonDisplayState
för att skapa en hjälpmedelskompatibel meny som fungerar med de flesta skärmläsare. I exemplen utförs följande uppgifter:
- Egenskapen
Accessibility.active
spåras för att fastställa om en skärmläsare är aktiv och kommunicerar med spelaren. - Om egenskapen
active
returnerartrue
anropar exemplet metodenupdateProperties()
så att hjälpmedelsförändringar tillämpas på knapparna i det här exemplet. - Exemplet anropar
flash.utils.setTimeout()
-metoden och anger attupdateAccessibility()
-stängningsmetoden ska anropas om 2 sekunder.
Obs: Anropa setTimeout()
innan du kontrollerar Accessibility.active
så att Flash Player får de 2 sekunder som behövs för att ansluta till en skärmläsare om en sådan finns tillgänglig. Utan tillräcklig fördröjning kan setTimeout
-anropet returnera false
trots att en skärmläsare finns tillgänglig.
I följande exempel bearbetas Accessibility.updateProperties()
-metod bara om anropet till Accessibility.active
returnerar true
, vilket bara sker om Flash Player är ansluten till en aktiv skärmläsare. Om updateProperties
anropas utan aktiv skärmläsare orsakar den ett IllegalOperationError
-undantag.
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(); } }
Tue Jun 12 2018, 01:40 PM Z