Adobe® Flash® Platform için ActionScript® 3.0 Başvurusu
Ana Sayfa  |  Paket ve Sınıf Listesini Gizle |  Paketler  |  Sınıflar  |  Yenilikler  |  Dizin  |  Ekler  |  Niçin İngilizce?
Filtreler: Sunucudan Veri Alınıyor...
Sunucudan Veri Alınıyor...
flash.accessibility 

AccessibilityProperties  - AS3

Paketflash.accessibility
Sınıfpublic class AccessibilityProperties
Miras AlmaAccessibilityProperties Inheritance 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

AccessibilityProperties sınıfı, Flash nesnelerinin ekran okuyucular gibi erişilebilirlik yardımcılarına sunumunu kontrol etmenizi sağlar.

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.

Örnekleri görüntüle

İlgili API Öğeleri



Genel Özellikler
 ÖzellikTanımlayan:
 Inheritedconstructor : 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
Genel Yöntemler
 YöntemTanımlayan:
  
Yeni AccessibilityProperties nesnesi oluşturur.
AccessibilityProperties
 Inherited
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.
Object
 Inherited
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.
Object
 Inherited
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.
Object
 Inherited
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.
Object
 Inherited
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.
Object
 Inherited
Belirtilen nesnenin dize olarak temsil edilen halini döndürür.
Object
 Inherited
Belirtilen nesnenin temel değerini döndürür.
Object
Özellik Ayrıntısı

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.

Yapıcı Ayrıntı

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.

AccessibilityPropertiesExample.as

Şu örnekte, ortak ekran okuyucularla birlikte çalışan erişilebilirlik uyumlu bir menü oluşturmak için AccessibilityExample, CustomAccessibleButton, CustomSimpleButton ve ButtonDisplayState sınıfları kullanılmaktadır. AccessibilityProperties sınıfının temel·işlevleri·şöyledir:
  1. Ö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.
  2. 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();
    }
}
}




[ X ]Niçin İngilizce?
ActionScript 3.0 Başvurusu'ndaki içerik İngilizce görünür

ActionScript 3.0 Başvurusu'nun tüm bölümleri tüm dillere çevrilmemiştir. Bir dil öğesi çevrilmediğinde İngilizce görünür. Örneğin, ga.controls.HelpBox sınıfı hiçbir dile çevrilmez. Bu nedenle, başvurunun Türkçe versiyonunda ga.controls.HelpBox sınıfı İngilizce görünür.