Pakiet | flash.accessibility |
Klasa | public final class Accessibility |
Dziedziczenie | Accessibility Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Obsługa w przeglądarkach na urządzeniach mobilnych: Ta klasa nie jest obsługiwana w przeglądarkach na urządzeniach przenośnych.
Obsługa profilów AIR: Ta funkcja jest obsługiwana we wszystkich systemach operacyjnych dla komputerów stacjonarnych, ale nie jest obsługiwana na urządzeniach przenośnych ani na urządzeniach telewizyjnych ze środowiskiem AIR. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.
Do pobierania i ustawiania właściwości ułatwień dostępu konkretnego obiektu, takiego jak przycisk, klip filmowy lub pole tekstowe, służy właściwość DisplayObject.accessibilityProperties
. Aby ustalić, czy odtwarzacz lub środowisko wykonawcze działa w środowisku obsługującym ułatwienia dostępu, należy skorzystać z właściwości Capabilities.hasAccessibility
.
Uwaga: Środowisko AIR 2 obsługuje czytnik ekranu JAWS 11 (i nowsze wersje). Dodatkowe informacje można znaleźć pod adresem http://www.adobe.com/accessibility/.
Więcej informacji
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
active : Boolean [statyczny] [tylko do odczytu]
Wskazuje, czy czytnik ekranu jest aktywny i aplikacja komunikuje się z nim. | Accessibility | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
[statyczny]
Nakazuje programowi Flash Player zastosowanie wszelkich zmian dostępności, które wprowadzono za pomocą właściwości DisplayObject.accessibilityProperties. | Accessibility | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object |
active | właściwość |
active:Boolean
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Wskazuje, czy czytnik ekranu jest aktywny i aplikacja komunikuje się z nim. Tej metody należy użyć, jeśli w obecności czytnika ekranu aplikacja ma się zachowywać w sposób inny niż standardowy.
Gdy właściwość ta raz zostanie ustawiona na true
, zachowuje wartość true
przez cały okres działania aplikacji. (Jest mało prawdopodobne, że użytkownik uruchomi czytnik ekranu, a potem go wyłączy.)
Uwaga: Nie należy wywoływać tej metody, nie odczekawszy wcześniej 1 lub 2 sekund po uruchomieniu aplikacji AIR lub po pierwszym wyświetleniu okna odtwarzacza Flash® Player, w którym odtwarzany jest dokument. Zbyt wczesne wywołanie metody może spowodować zwrócenie wartości false
, mimo obecności aktywnego klienta ułatwień dostępu. Wynika to z faktu, że klienty ułatwień dostępu komunikują się z odtwarzaczem Flash Player i środowiskiem AIR w sposób asynchroniczny.
Capabilities.hasAccessibility
.
Implementacja
public static function get active():Boolean
Powiązane elementy interfejsu API
updateProperties | () | metoda |
public static function updateProperties():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9 |
Nakazuje programowi Flash Player zastosowanie zmian w ułatwieniach dostępu wprowadzonych za pośrednictwem właściwości DisplayObject.accessibilityProperties
. Należy wywołać tę metodę, aby zmiany odniosły skutek.
Po zmodyfikowaniu właściwości ułatwień dostępu wielu obiektów wymagane jest tylko jedno wywołanie metody Accessibility.updateProperties()
; wiele wywołań może spowodować pogorszenie wydajności i nieprawidłowe działanie czytnika ekranu.
Zgłasza
IllegalOperationError — W tej wersji programu Flash Player nie są obsługiwane ułatwienia dostępu. Nie należy wywoływać metody Accessibility.updateProperties() , jeśli właściwość flash.system.Capabilities.hasAccessibility jest równa false .
|
Powiązane elementy interfejsu API
AccessibilityExample
, CustomAccessibleButton
, CustomSimpleButton
i ButtonDisplayState
w celu stworzenia menu zgodnego z ułatwieniami dostępu. Takie menu będzie współpracować z większością czytników ekranu. Przykładowy kod realizuje następujące zadania:
- Sprawdza właściwość
Accessibility.active
w celu ustalenia, czy czytnik ekranu jest aktywny i czy odtwarzacz się z nim komunikuje. - Jeśli właściwość
active
zwróci wartośćtrue
, przykładowy kod wywołuje metodęupdateProperties()
w celu zastosowania zmian dokonanych w przyciskach na potrzeby ułatwień dostępu. - Wywoływana jest metoda
flash.utils.setTimeout()
w celu określenia, że metoda zamykającaupdateAccessibility()
powinna zostać wywołana po 2 sekundach.
Uwaga: Wywołanie setTimeout()
powinno nastąpić przed sprawdzeniem właściwości Accessibility.active
, aby program Flash Player miał 2 sekundy potrzebne na połączenie się z czytnikiem ekranu, jeśli jest on dostępny. Jeśli nie zostawimy wystarczającego opóźnienia, wywołanie metody setTimeout
może zwrócić wartość false
mimo że czytnik ekranu będzie dostępny.
W poniższym przykładzie metoda Accessibility.updateProperties()
jest wykonywana pod warunkiem, że wywołanie metody Accessibility.active
zwróci wartośc true
, co ma miejsce, jeśli program Flash Player jest obecnie połączony z aktywnym czytnikiem ekranu. Wywołanie metody updateProperties
w sytuacji, gdy nie ma aktywnego czytnika ekranu, generowany jest wyjątek IllegalOperationError
.
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, 12:06 PM Z