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.external 

ExtensionContext  - AS3

Paketflash.external
Sınıfpublic final class ExtensionContext
Miras AlmaExtensionContext Inheritance EventDispatcher Inheritance Object

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

ExtensionContext sınıfı ayrıca, uzantının aygıtta yüklü olduğu dizine erişmek için bir getExtensionDirectory() statik yöntemi sağlar. Ayrıca, uzantının yerel uygulamasıyla veri paylaşmak için kullanılabilecek bir actionScriptData özelliği de sunar.

Not: extendedDesktop profilini kullanan AIR uygulamaları, yerel işlemleri yürütmek için NativeProcess sınıfını kullanabilir.

İlgili API Öğeleri



Genel Özellikler
 ÖzellikTanımlayan:
      actionScriptData : Object
Varsa, bu bağlamla ilişkili ActionScript nesnesi.
ExtensionContext
 Inheritedconstructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.
Object
Genel Yöntemler
 YöntemTanımlayan:
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder.
EventDispatcher
  
    call(functionName:String, ... args):Object
functionName tarafından belirtilen yerel işlevi çağırır.
ExtensionContext
  
    createExtensionContext(extensionID:String, contextType:String):ExtensionContext
[statik] Belirli bir uzantı kimliği ve bağlam türü için bir ExtensionContext örneği oluşturur.
ExtensionContext
 Inherited
Olay akışına bir olay gönderir.
EventDispatcher
  
    dispose():void
Bu ExtensionContext örneğini atar.
ExtensionContext
  
    getExtensionDirectory(extensionID:String):File
[statik] Uzantının aygıtta yüklü olduğu dizini döndürür.
ExtensionContext
 Inherited
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.
EventDispatcher
 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
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher nesnesinden bir dinleyiciyi kaldırır.
EventDispatcher
 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
 Inherited
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder.
EventDispatcher
Olaylar
 Olay Özet Tanımlayan:
 Inherited[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir.EventDispatcher
 Inherited[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.EventDispatcher
  
    status
ExtensionContext sınıfı, Adobe AIR'ye yönelik yerel bir uzantının yerel uygulamasındaki işlevlerin çağrılması için bir arabirim sağlar.ExtensionContext
Özellik Ayrıntısı
    

actionScriptData

özellik
actionScriptData:Object

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

Varsa, bu bağlamla ilişkili ActionScript nesnesi.

Herhangi bir ActionScript nesnesini bir ExtensionContext örneğiyle ilişkilendirebilirsiniz. Yerel uygulama da bu ActionScript nesnesini alıp ayarlayabilir. Bu yüzden, bir uzantının ActionScript tarafı ile yerel tarafı arasında veri paylaşmak için actionScriptData öğesini kullanabilirsiniz.

Ayrıca actionScriptData öğesinin değerini null olarak da ayarlayabilirsiniz.



Uygulama
    public function get actionScriptData():Object
    public function set actionScriptData(value:Object):void

Atar
IllegalOperationError dispose() yöntemi bu ExtensionContext örneğinde zaten çağrıldı.
Yöntem Ayrıntısı

    call

()yöntem
public function call(functionName:String, ... args):Object

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

functionName tarafından belirtilen yerel işlevi çağırır. Ek argümanlar yerel işleve iletilir.

Parametreler

functionName:String — Yerel uygulamadaki bir işlevi temsil eden bir ad. Bu adın yerel işlevin gerçek adı olması gerekmez, ancak uzantının ActionScript tarafı ile yerel tarafı arasında kabul edilen herhangi bir ad olabilir.
 
... args — Yerel işleve yönelik argümanların listesi. Bu argümanlar ActionScript nesneleri olabilir: Temel türler veya ActionScript sınıfı nesneler. Argümanların türleri ve sırası, uzantının ActionScript tarafı ile yerel tarafı tarafından kabul edilir.

Döndürür
Object — Yerel işlev tarafından döndürülen değer. Yerel işlevin dönüş değeri yoksa veya geçersiz bir nesne başvurusu döndürürse dönüş değeri null şeklinde olur.

Atar
ArgumentError — Hiçbir işlev functionName tarafından belirtilen adla eşleşmiyor.
 
IllegalOperationError dispose() yöntemi bu ExtensionContext örneğinde zaten çağrıldı. Yerel işlevin geçersiz bir nesne başvurusu döndürmesi halinde de bu hata verilir.

    createExtensionContext

()yöntem 
public static function createExtensionContext(extensionID:String, contextType:String):ExtensionContext

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

Belirli bir uzantı kimliği ve bağlam türü için bir ExtensionContext örneği oluşturur.

Parametreler

extensionID:String — Uzantının uzantı kimliği. Bu kimlik, uzantı açıklaması dosyasındaki id öğesiyle aynı değere sahiptir. Uygulama açıklaması dosyasındaki extensionID öğesinde bulunan bu değeri uygulama geliştiricileri de kullanılırlar. Tüm uzantılar tek bir genel ad alanını paylaşır. Bu yüzden, ad çakışmalarını önlemek için, uzantı kimliği için ters DNS gösterimi kullanın.
 
contextType:String — Uzantının bağlam türü. Bağlam türüne göre, yerel uygulama farklı başlatma işlemleri gerçekleştirebilir. Bu farklar, ActionScript tarafının çağırabileceği farklı bir kullanılabilir yerel işlev kümesi belirten yerel uygulamayı içerebilir. Bağlam türünün değeri, uzantının ActionScript tarafı ile yerel tarafı arasında kabul edilen herhangi bir dizedir. Basit uzantılar genellikle farklı bağlam türleri için kullanılamazlar. Böyle durumlarda, contextType değeri için boş bir dize "" veya null değeri iletin.

Döndürür
ExtensionContext — Yeni ExtensionContext örneği. Belirli extensionID değeriyle birlikte uzantı yoksa veya belirli extensionID öğesine yönelik extension.xml belgesinde belirtilen bağlam başlatıcı işlevi bulunamıyorsa ya da çalıştırılamıyorsa null değerini döndürür.

Atar
ArgumentError extensionID parametresi null şeklindedir veya geçerli bir uzantı kimliği değildir.

    dispose

()yöntem 
public function dispose():void

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

Bu ExtensionContext örneğini atar.

Çalışma zamanı yerel uygulamayı bilgilendirir ve bu uygulama da ilişkili yerel kaynakları serbest bırakabilir. dispose() yöntemi çağrıldıktan sonra, kod call() yöntemini çağıramaz ve actionScriptData özelliğini ayarlayamaz veya alamaz.

    getExtensionDirectory

()yöntem 
public static function getExtensionDirectory(extensionID:String):File

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

Uzantının aygıtta yüklü olduğu dizini döndürür.

Bazen bir uzantı, uzantının ActionScript kodundan erişmek istediğiniz görüntüler gibi kaynaklar içerir. Ayrıca, kod bazen uzantı sürüm numarası gibi uzantı açıklaması dosyasında bulunan bilgileri de gerektirir. Uzantının taban dizinine erişmek için bu yöntemi kullanabilirsiniz.

Uzantının dosyaları, uzantının aygıtta nerede bulunduğuna bakılmaksızın, her zaman uzantıya ait bu taban dizinine göre aynı konumda bulunur. Bu yöntemin döndürdüğü File örneğini kullanarak, uzantının içerdiği belirli dosyalara gidebilir ve bu dosyaları yönlendirebilirsiniz.

Uzantı dizini aşağıdaki yapıya sahiptir:

			 extension base directory/
			      platform independent files
			      META-INF/
			           ANE/
			                extension.xml
			                platform name/
			                     platform-dependent files and directories
			 

Uzantı dizini konumu, aşağıda belirtildiği şekilde, uzantının uygulama paketi veya aygıt paketi ile kullanıma sunulup sunulmadığına bağlıdır:

  • Uygulama paketiyle, uzantı dizini uygulama dizininin içinde bulunur.
  • Aygıt paketiyle, uzantı dizini konumu aygıta bağlıdır.

iOS aygıtları için yerel uzantılara yönelik getExtensionDirectory() kullanımının istisnası mevcuttur. Bu uzantılara yönelik kaynaklar, uzantı dizininde bulunmaz. Bunun yerine, üst düzey uygulama dizininde bulunur.

Parametreler

extensionID:String — Uzantının uzantı kimliği. Bu kimlik, createExtensionContext() öğesindeki extensionID parametresiyle aynı değere sahiptir.

Döndürür
File — Uzantının yüklü olduğu dizin için bir File örneği.

Atar
TypeError extensionID parametresinin null olmaması gerekir.
 
ArgumentError extensionID argümanı için belirtilen değer geçersiz. Dizin yok.
Olay Ayrıntısı
    

status

Olay
Olay Nesne Türü: flash.events.StatusEvent
özellik StatusEvent.type = flash.events.StatusEvent.STATUS

Dil Sürümü: ActionScript 3.0
Çalışma Zamanı Sürümleri: AIR 2.5

ExtensionContext sınıfı, Adobe AIR'ye yönelik yerel bir uzantının yerel uygulamasındaki işlevlerin çağrılması için bir arabirim sağlar. Bu sınıfı yalnızca uzantının bir parçası olan ActionScript sınıflarında kullanabilirsiniz.

AIR profil desteği: Bu özellik AIR 3'ten itibaren mobil aygıtlarda desteklenmektedir. Ayrıca AIR 3'ten itibaren masaüstü aygıtlardaki extendedDesktop aygıt profilini kullanan uygulamalarda desteklenmektedir. AIR 2.5'ten itibaren, AIR for TV aygıtlarındaki extendedTV aygıt profilini kullanan uygulamalarda desteklenmektedir.

Bir yerel uzantı aşağıdakilerin bir kombinasyonudur:

  • ActionScript sınıfları.
  • Yerel kod. Yerel kod, çalışma zamanı dışında bir aygıt üzerinde yürütülen koddur. Örneğin, C'de yazdığınız kod yerel koddur.

Şu amaçlar için bir yerel uzantı oluşturabilirsiniz:

  • Bir AIR uygulamasına aygıta özgü özellikler için erişim verme.
  • Varolan yerel kodu yeniden kullanma.
  • Yerel kodu kullanarak, ActionScript koduyla sağlayabileceğinizden daha verimli işleme sağlama.

Uzantının yerel tarafına erişmek için bir uzantısının ActionScript tarafındaki ExtensionContext sınıfını kullanın. Öncelikle ExtensionContext sınıfının bir örneğini oluşturun. Bunun için, ExtensionContext.createExtensionContext() statik yöntemini çağırın.

ExtensionContext örneğini oluşturduktan sonra, yerel bir işlevi çağırmak için örneğin call() yöntemini kullanın.

ExtensionContext örneğiyle işiniz bittiğinde, ilişkili yerel kaynakları serbest bırakmak için dispose() yöntemini çağırın. Çalışma zamanı çöp toplayıcısı örneği attığında dispose() yöntemine açık bir çağrı olmadan dispose() yöntemini çağırır. dispose() yöntemine açık bir çağrının yapılması, genellikle çöp toplayıcısı beklenmeden çok önce gerçekleşir.

Bir ExtensionContext örneği, uzantının yerel uygulamasında bir eşzamansız olay gerçekleştiğinde yerel kodun gönderdiği StatusEvent olaylarını dinleyebilir. ExtensionContext sınıfı EventDispatcher öğesinden türetildiğinden, olayları gönderebilir.

status olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

ÖzellikDeğer
bubblesfalse
cancelablefalse; iptal edilecek varsayılan davranış yoktur.
codeNesne durumunun bir açıklaması.
currentTargetBu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
düzeyMesajın kategorisi; örneğin, "status", "warning" veya "error".
targetDurumunu bildiren nesne.




[ 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.