Paket | flash.accessibility |
Sınıf | public class AccessibilityProperties |
Miras Alma | AccessibilityProperties Object |
Alt Sınıflar | UIComponentAccImpl, UIComponentAccProps |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Bir AccessibilityProperties nesnesini her türlü görüntüleme·nesnesine ekleyebilirsiniz, ancak Flash Player, AccessibilityProperties nesnenizi yalnızca belirli nesne türleri için okur: bütün SWF dosyaları (DisplayObject.root
, kap nesneleri (DisplayObjectContainer
ve alt sınıfları), düğmeler (SimpleButton
ve alt sınıfları) ve metin·(TextField
ve alt sınıfları) ile temsil edilenler).
Erişilebilirlik yardımcıları kullanıcılara temel gezinme araçları olarak nesnelerin adlarını sağladığı için, bu nesnelerin name
özelliği, belirtilmesi gereken en önemli özelliktir. AccessibilityProperties.name
ve DisplayObject.name
'i birbirine karıştırmayın; bunlar ayrıdır ve birbiriyle ilişkili değildir. AccessibilityProperties.name
özelliği, erişilebilirlik yardımcıları tarafından yüksek sesle okunan bir addır, DisplayObject.name
ise temelde yalnızca ActionScript kodu tarafından görülebilen bir değişken adıdır.
Flash Professional'da, AccessibilityProperties
nesnelerinin özellikleri, geliştirme·sırasında Erişilebilirlik·panelinde kullanılabilir olan ilgili ayarları geçersiz kılar.
Flash Player'ın erişilebilirlik yardımcılarını destekleyen bir ortamda çalışıp·çalışmadığını·belirlemek için, Capabilities.hasAccessibility
özelliğini kullanın. AccessibilityProperties nesnelerini değiştirirseniz, değişikliklerin etkili olması için Accessibility.updateProperties()
yöntemini çağırmanız gerekir.
İlgili API Öğeleri
flash.display.DisplayObject.accessibilityProperties
flash.display.InteractiveObject.tabIndex
flash.system.Capabilities.hasAccessibility
Özellik | Tanımlayan: | ||
---|---|---|---|
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
description : String
Bu ekran nesnesine erişilebilir sunumda bir açıklama sağlar. | AccessibilityProperties | ||
forceSimple : Boolean
true ise·Flash Player'ın bu ekran nesnesindeki tüm alt nesneleri erişilebilir sunumdan çıkarmasına neden olur. | AccessibilityProperties | ||
name : String
Bu ekran nesnesine erişilebilir sunumda bir ad sağlar. | AccessibilityProperties | ||
noAutoLabeling : Boolean
true ise Flash Player varsayılan otomatik etiketleme sistemini etkisizleştirir. | AccessibilityProperties | ||
shortcut : String
Bu ekran nesnesi ile ilişkili bir klavye kısayolunu gösterir. | AccessibilityProperties | ||
silent : Boolean
true ise bu ekran nesnesini erişilebilir sunumdan çıkarır. | AccessibilityProperties |
Yöntem | Tanımlayan: | ||
---|---|---|---|
Yeni AccessibilityProperties nesnesi oluşturur. | AccessibilityProperties | ||
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 | ||
Belirtilen nesnenin temel değerini döndürür. | Object |
description | özellik |
public var description:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Bu ekran nesnesine erişilebilir sunumda bir açıklama sağlar. Nesne hakkında sunulacak çok fazla bilgi olduğunda, en iyisi kısa bir ad seçmeniz ve içeriğinizin çoğunu description
özelliğine eklemeniz olacaktır. Tam SWF dosyaları, kaplar, düğmeler ve metne uygulanır. Varsayılan değer boş bir dizedir.
Flash Professional’da bu özellik Erişilebilirlik panelindeki Açıklama alanına karşılık gelir.
forceSimple | özellik |
public var forceSimple:Boolean
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
true
ise·Flash Player'ın bu ekran nesnesindeki tüm alt nesneleri erişilebilir sunumdan çıkarmasına neden olur. Varsayılan değer·false
'dur. Tam SWF dosyalarına ve kaplara uygulanır.
name | özellik |
public var name:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Bu ekran nesnesine erişilebilir sunumda bir ad sağlar. Tam SWF dosyaları, kaplar, düğmeler ve metne uygulanır. DisplayObject.name
ile karıştırmayın, bu ikisi birbiriyle ilişkili değildir. Varsayılan değer boş bir dizedir.
Flash Professional’da bu özellik Erişilebilirlik panelindeki Ad alanına karşılık gelir.
noAutoLabeling | özellik |
public var noAutoLabeling:Boolean
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
true
ise Flash Player varsayılan otomatik etiketleme sistemini etkisizleştirir. Otomatik etiketleme, düğmelerin içindeki metin nesnelerinin düğme adları olarak ve metin alanlarının yanındaki metin nesnelerinin metin alanı adları olarak işlem görmesini sağlar. Varsayılan değer·false
'dur. Yalnızca tam SWF dosyalarına uygulanır.
noAutoLabeling
özellik değeri, bir erişilebilirlik yardımcısı SWF dosyanızı ilk kez incelemeden önce belirtmediğiniz takdirde yok sayılır. noAutoLabeling
değerini true
olarak ayarlamayı planlıyorsanız, bunu kodunuzda mümkün olduğu kadar erken yapmanız gerekir.
shortcut | özellik |
public var shortcut:String
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Bu ekran nesnesi ile ilişkili bir klavye kısayolunu gösterir. Bu dizeyi yalnızca bir kısayol tuşuyla ilişkilendirdiğiniz kullanıcı arabirimi denetimleri için sağlayın. Kaplar, düğmeler ve metne uygulanır. Varsayılan değer boş bir dizedir.
Not: Bu özellik atandığında, belirtilen tuş kombinasyonu bu objeye otomatik olarak atanmaz; bu işlemi, örneğin bir KeyboardEvent
'i dinleyerek kendiniz yapmalısınız.
Bu dizenin sözdizimi, değiştirici tuşlar için uzun adlar ve tuş kombinasyonunu göstermek için artı(+) karakterini kullanır. Geçerli dize örnekleri, “Ctrl+F“, “Ctrl+Shift+Z“ ve benzerleridir.
silent | özellik |
public var silent:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
true
ise bu ekran nesnesini erişilebilir sunumdan çıkarır. Varsayılan değer·false
'dur. Tam SWF dosyaları, kaplar, düğmeler ve metne uygulanır.
AccessibilityProperties | () | Yapıcı |
public function AccessibilityProperties()
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Yeni AccessibilityProperties nesnesi oluşturur.
AccessibilityExample
, CustomAccessibleButton
, CustomSimpleButton
ve ButtonDisplayState
sınıfları kullanılmaktadır. AccessibilityProperties
sınıfının temel·işlevleri·şöyledir:
- Özel bir düğme yaratarak etiketini ve tanımını ayarlayan
configureAssets
'i çağırma. Bunlar, ekran okuyucunun son kullanıcıya ilettiği değerlerdir. - Flash Player'ın özellikleri güncellemeden önce ekran okuyucuyu saptamak için yeterli süreye sahip olmasını sağlamak için
setTimeOut()
'u çağırma.
Not: Accessibility.active
'i işaretlemeden önce, setTimeout()
'u çağırın. Kullanılabilir bir ekran okuyucu varsa,·Flash Player'ın, buna bağlanması için gereken 2 saniyeyi sağlamak için bu gereklidir. 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 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(); } } }
Tue Jun 12 2018, 01:09 PM Z