| Paket | flash.external |
| Sınıf | public final class ExtensionContext |
| Miras Alma | ExtensionContext  EventDispatcher 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
Miras Alınan Genel Özellikleri Gizle
Miras Alınan Genel Özellikleri Göster| Özellik | Tanımlayan: | ||
|---|---|---|---|
| actionScriptData : Object
Varsa, bu bağlamla ilişkili ActionScript nesnesi. | ExtensionContext | ||
 | 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: | ||
|---|---|---|---|
| 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 | |
functionName tarafından belirtilen yerel işlevi çağırır. | ExtensionContext | ||
[statik]
Belirli bir uzantı kimliği ve bağlam türü için bir ExtensionContext örneği oluşturur. | ExtensionContext | ||
|
Olay akışına bir olay gönderir. | EventDispatcher | |
Bu ExtensionContext örneğini atar. | ExtensionContext | ||
[statik]
Uzantının aygıtta yüklü olduğu dizini döndürür. | ExtensionContext | ||
|
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | EventDispatcher | |
|
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 | |
|
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | |
|
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 | |
|
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 | |
| Olay | Özet | Tanımlayan: | ||
|---|---|---|---|---|
| [broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir. | EventDispatcher | ||
| [broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir. | EventDispatcher | ||
| 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 | |||
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):voidAtar
IllegalOperationError — dispose() yöntemi bu ExtensionContext örneğinde zaten çağrıldı.
|
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.
|
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.
|
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.
|
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.
|
status | Olay |
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:
| Özellik | Değer |
|---|---|
bubbles | false |
cancelable | false; iptal edilecek varsayılan davranış yoktur. |
code | Nesne durumunun bir açıklaması. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
düzey | Mesajın kategorisi; örneğin, "status", "warning" veya "error". |
target | Durumunu bildiren nesne. |
Tue Jun 12 2018, 01:09 PM Z