Paket | flash.accessibility |
Sınıf | public final class Accessibility |
Miras Alma | Accessibility Object |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Mobil Tarayıcı Desteği: Bu sınıf mobil tarayıcılarda desteklenmez.
AIR profili desteği: Bu özellik tüm masaüstü işletim sistemlerinde desteklenir ancak mobil aygıtlarda veya AIR for TV aygıtlarında desteklenmez. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.
Düğme, film klibi veya metin alanı gibi belirli bir nesne için erişilebilir özellikleri almak ve ayarlamak için, DisplayObject.accessibilityProperties
özelliğini kullanın. Oynatıcının veya çalışma zamanının erişilebilirlik yardımcılarını destekleyen bir ortamda çalışıp·çalışmadığını·belirlemek için, Capabilities.hasAccessibility
özelliğini kullanın.
Not:AIR 2 JAWS 11 (veya daha yüksek) ekran okuyucu yazılımı destekler. Ek bilgi için bkz. http://www.adobe.com/accessibility/.
Daha fazla bilgi
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
active : Boolean [statik] [salt okunur]
Bir ekran okuyucunun etkin olup olmadığını ve uygulamanın·onunla iletişimde olup olmadığını·gösterir. | Accessibility | ||
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object |
Yöntem | Tanımlayan: | ||
---|---|---|---|
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | ||
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | Object | ||
[statik]
Flash Player'a DisplayObject.accessibilityProperties özelliği kullanılarak yapılan tüm erişilebilirlik değişikliklerini uygulamasını söyler. | Accessibility | ||
Belirtilen nesnenin temel değerini döndürür. | Object |
active | özellik |
active:Boolean
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Bir ekran okuyucunun etkin olup olmadığını ve uygulamanın·onunla iletişimde olup olmadığını·gösterir. Uygulamanızın bir ekran okuyucu varolduğunda farklı davranmasını isterseniz bu yöntemi kullanın.
Bu özellik true
değerine ayarlandığı zaman uygulamanın süresi boyunca true
olarak kalır. (Bir ekran okuyucusu bir kere başlatıldıktan sonra bir kullanıcının onu kapatması olağan değildir.)
Not: Bu yöntemi çağırmadan önce, AIR uygulamanızı başlattıktan sonra veya belgenizin oynatıldığı Flash ® Player penceresinin ilk görünmesinden sonra 1 veya 2 saniye bekleyin. Yoksa, etkin bir erişilebilirlik istemcisi olsa da bir false
döndürme değeri alabilirsiniz. Bu erişilebilirlik istemcileri ve Flash Player veya AIR arasındaki senkronize olmayan bir iletişim mekanizmasından dolayı olur.
Capabilities.hasAccessibility
özelliğini kullanın.
Uygulama
public static function get active():Boolean
İlgili API Öğeleri
updateProperties | () | yöntem |
public static function updateProperties():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Flash Player'a DisplayObject.accessibilityProperties
özelliği kullanılarak yapılan tüm erişilebilirlik değişikliklerini uygulamasını söyler. Değişikliklerinizin etkili olması için bu yöntemi çağırmanız gerekir.
Birden fazla·nesnenin erişilebilirlik özelliklerini değiştirdiğinizde, Accessibility.updateProperties()
yöntemini yalnızca bir kez çağırmanız gerekir; birden fazla çağrı, performans düşüklüğüne ve ekran okuyucu çıktısının hatalı olmasına neden olabilir.
Atar
IllegalOperationError — Flash Player'ın bu sürümünde erişilebilirlik desteklenmemektedir. flash.system.Capabilities.hasAccessibility özelliği false olduğunda Accessibility.updateProperties() yöntemini çağırmayın.
|
İlgili API Öğeleri
AccessibilityExample
, CustomAccessibleButton
, CustomSimpleButton
ve ButtonDisplayState
örnek sınıfları kullanılmaktadır. Örnekte şu görevler yerine getirilmektedir:
- Bir ekran okuyucunun etkin olup olmadığını ve oynatıcının bu ekran okuyucuyla iletişimde olup olmadığını belirlemek için,
Accessibility.active
özelliğini izler. active
özelliğitrue
değerini döndürürse örnek, bu örnekteki düğmelerde yapılan erişilebilirlik değişikliklerini uygulamak içinupdateProperties()
yöntemini kullanır.- Örnek, 2 saniye sonra
updateAccessibility()
kapanış·yönteminin çağrılacağını belirtenflash.utils.setTimeout()
yöntemini çağırır.
Not: Kullanılabilir bir ekran okuyucu varsa,·Flash Player'ın buna bağlanması için gereken 2 saniyeyi sağlamak için, Accessibility.active
'i işaretlemeden önce setTimeout()
'u çağırın. Yeterli bir gecikme·süresi sağlamazsanız, ekran okuyucu kullanılabilir olsa bile, setTimeout
çağrısı false
değerini döndürebilir.
Şu örnekte, yalnızca Flash Player o anda etkin bir ekran okuyucuya bağlıyken Accessibility.active
çağrısı true
değerini döndürürse Accessibility.updateProperties()
yöntemi işlenir. updateProperties
etkin bir ekran okuyucu olmadan çağrıldığında, IllegalOperationError
istisnası verir.
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:09 PM Z