| 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
Miras Alınan Genel Özellikleri Gizle
Miras Alınan Genel Özellikleri Göster