| Paket | flash.desktop |
| Sınıf | public final class NativeApplication |
| Miras Alma | NativeApplication EventDispatcher Object |
| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
NativeApplication sınıfı, uygulama bilgilerini, uygulama genelindeki işlevleri sağlar ve uygulama düzeyindeki olayları gönderir.
NativeApplication nesnesi, başlangıçta otomatik olarak oluşturulan tekil bir nesnedir. Bir uygulamanın NativeApplication örneğini NativeApplication.nativeApplication statik özelliğiyle alın.
| Özellik | Tanımlayan: | ||
|---|---|---|---|
| activeWindow : NativeWindow [salt okunur]
Etkin uygulama penceresi | NativeApplication | ||
| applicationDescriptor : XML [salt okunur]
Bu AIR uygulamasına yönelik uygulama açıklayıcı dosyasının içeriği. | NativeApplication | ||
| applicationID : String [salt okunur]
Bu uygulamanın uygulama kimliği. | NativeApplication | ||
| autoExit : Boolean
Tüm pencereler kapandığında uygulamanın otomatik olarak sonlandırılıp sonlandırılmaması gerektiğini belirtir. | NativeApplication | ||
![]() | constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | |
| executeInBackground : Boolean
Uygulamanın arka planda çalışıp çalışmayacağını belirtir. | NativeApplication | ||
| icon : InteractiveIcon [salt okunur]
Uygulama simgesi. | NativeApplication | ||
| idleThreshold : int
userIdle olayı gönderilmeden önce kullanıcı girdisi olmadan geçmesi gereken saniye sayısı. | NativeApplication | ||
| isCompiledAOT : Boolean [salt okunur]
Uygulamanın istenen platform için derlendiğini veya yorumlandığını belirtir. | NativeApplication | ||
| menu : NativeMenu
Uygulama menüsü. | NativeApplication | ||
| nativeApplication : NativeApplication [statik] [salt okunur]
NativeApplication nesnesinin tekil örneği. | NativeApplication | ||
| openedWindows : Array [salt okunur]
Bu uygulamanın açık olan tüm yerel pencerelerini içeren bir dizi. | NativeApplication | ||
| publisherID : String [salt okunur]
Bu uygulamanın yayıncı kimliği. | NativeApplication | ||
| runtimePatchLevel : uint [salt okunur]
Bu uygulamayı barındıran çalışma zamanının yama düzeyi. | NativeApplication | ||
| runtimeVersion : String [salt okunur]
Bu uygulamayı barındıran çalışma zamanının sürüm numarası. | NativeApplication | ||
| startAtLogin : Boolean
Geçerli kullanıcı her oturum açtığında bu uygulamanın otomatik olarak başlatılıp başlatılmayacağını belirtir. | NativeApplication | ||
| supportsDefaultApplication : Boolean [statik] [salt okunur]
setAsDefaultApplication(), removeAsDefaultApplication() ve isSetAsDefaultApplication() öğelerinin geçerli platformda desteklenip desteklenmediğini gösterir. | NativeApplication | ||
| supportsDockIcon : Boolean [statik] [salt okunur]
AIR'nin geçerli işletim sisteminde simge seti stilinde uygulama simgelerini destekleyip desteklemediğini belirtir. | NativeApplication | ||
| supportsMenu : Boolean [statik] [salt okunur]
Geçerli işletim sisteminin global uygulama menüsü çubuğunu destekleyip desteklemediğini belirtir. | NativeApplication | ||
| supportsStartAtLogin : Boolean [statik] [salt okunur]
startAtLogin öğesinin geçerli platformda desteklenip desteklenmediğini belirtir. | NativeApplication | ||
| supportsSystemTrayIcon : Boolean [statik] [salt okunur]
AIR'nin geçerli işletim sisteminde sistem tepsisi simgelerini destekleyip desteklemediğini belirtir. | NativeApplication | ||
| systemIdleMode : String
Uygulamaların kullanıcı arabiriminin "boşta kalma" moduna geçmesini önlemesine olanak tanır. | NativeApplication | ||
| timeSinceLastUserInput : int [salt okunur]
Son kullanıcı girdisinden bu yana saniye cinsinden süre. | NativeApplication | ||
| Yöntem | Tanımlayan: | ||
|---|---|---|---|
Bu uygulamayı etkinleştirir. | NativeApplication | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [geçersiz kıl]
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. | NativeApplication | ||
Odaklanan görüntüleme nesnesine harici bir silme komutu çağırır. | NativeApplication | ||
Odaklanan görüntüleme nesnesine harici bir kopya komutu çağırır. | NativeApplication | ||
Odaklanan görüntüleme nesnesine harici bir kesme komutu çağırır. | NativeApplication | ||
[geçersiz kıl]
Olay akışına bir olay gönderir. | NativeApplication | ||
Bu uygulamayı sonlandırır. | NativeApplication | ||
Belirtilen uzantıya sahip dosyaları açmak için varsayılan uygulamayı alır. | NativeApplication | ||
![]() |
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 | |
Bu uygulamanın, dosyaları belirtilen uzantıyla açmak için kullanılan geçerli varsayılan uygulama olup olmadığını belirtir. | NativeApplication | ||
Odaklanan görüntüleme nesnesine harici bir yapıştırma komutu çağırır. | NativeApplication | ||
![]() |
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | |
Bu uygulamayı, dosyaları belirtilen uzantıyla açmak için kullanılan varsayılan olarak kaldırır. | NativeApplication | ||
[geçersiz kıl]
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | NativeApplication | ||
Odaklanan görüntüleme nesnesine harici bir selectAll komutu çağırır. | NativeApplication | ||
Bu uygulamayı, dosyaları belirtilen uzantıyla açmak için kullanılan varsayılan uygulama olarak ayarlar. | NativeApplication | ||
![]() |
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: | ||
|---|---|---|---|---|
| Bu uygulama etkin masaüstü uygulaması olduğunda gönderilir. | NativeApplication | |||
| Uygulama kullanıcının tarayıcısında çalışan bir SWF dosyası tarafından çağrıldığında gönderilir. | NativeApplication | |||
| Masaüstü odağı farklı bir uygulamaya geçirildiğinde gönderilir. | NativeApplication | |||
| Uygulamanın çıkış sırası başlatıldığında gönderilir. | NativeApplication | |||
| Bir uygulama çağrıldığında gönderilir. | NativeApplication | |||
| Kullanıcı bir tuşa bastığında gönderilir. | NativeApplication | |||
| Kullanıcı bir tuşu bıraktığında gönderilir. | NativeApplication | |||
| Yeni bir ağ bağlantısı kullanılabilir hale geldiğinde veya varolan ağ bağlantısı koptuğunda gönderilir. | NativeApplication | |||
| Uygulama işletim sistemi tarafından askıya alınmak üzereyken gönderilir. | NativeApplication | |||
| Kullanıcı boşta kaldığında gönderilir. | NativeApplication | |||
| İşletim sistemi, fareyi veya klavyeyi boşta geçen bir süre sonunda algıladığında gönderilir. | NativeApplication | |||
activeWindow | özellik |
activeWindow:NativeWindow [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Etkin uygulama penceresi
Etkin masaüstü penceresi bu uygulamaya ait değilse veya etkin pencere mevcut değilse, activeWindow null değerindedir.
Bu özellik NativeWindow sınıfını desteklemeyen platformlarda desteklenmez.
Uygulama
public function get activeWindow():NativeWindow applicationDescriptor | özellik |
applicationDescriptor:XML [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Bu AIR uygulamasına yönelik uygulama açıklayıcı dosyasının içeriği.
Uygulama
public function get applicationDescriptor():XMLÖrnek ( Bu örnek nasıl kullanılır? )
copyrightve version öğelerini uygulama açıklayıcı dosyasından okur. Uygulama açıklayıcı XML'inde tanımlanan varsayılan ad alanını kullanmanız gerektiğini unutmayın.
var appDescriptor:XML = NativeApplication.nativeApplication.applicationDescriptor;
var ns:Namespace = appDescriptor.namespace();
var appCopyright:String = appDescriptor.ns::copyright;
var appVersion:String = appDescriptor.ns::version;
trace("appId:", appCopyright);
trace("version:", appVersion);
applicationID | özellik |
autoExit | özellik |
autoExit:Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Tüm pencereler kapandığında uygulamanın otomatik olarak sonlandırılıp sonlandırılmaması gerektiğini belirtir.
autoExit öğesi varsayılan değer olan true olduğunda, tüm pencereler kapatıldığında uygulama sonlandırılır. Hem exiting hem de exit olayları gönderilir. autoExit false olduğunda, uygulamayı sonlandırmak için NativeApplication.nativeApplication.exit() öğesini çağırmalısınız.
Bu özellik NativeWindow sınıfını desteklemeyen platformlarda desteklenmez.
Uygulama
public function get autoExit():Boolean public function set autoExit(value:Boolean):void executeInBackground | özellik |
executeInBackground:Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 3.3 |
Uygulamanın arka planda çalışıp çalışmayacağını belirtir.
executeInBackground varsayılan değer olan false değerine sahip olduğunda, uygulama arka plana geçtiği zaman askıya alınmış durumda kalır. executeInBackground true olduğu zaman uygulama arka planda çalışabilir.
Not: swf sürümü 21 ve önceki sürümlerinde AIR, oluşturma modu direct (doğrudan) ayarlandığında iOS ve Android'de arka planda yürütmeyi desteklemez. Bu kısıtlama nedeniyle, Stage3D temelli uygulamalar ses yürütme, konum güncellemeleri, ağ yükleme veya indirme vb. gibi arka plan görevlerini yürütemez. iOS, arka planda OpenGLES veya çağrı oluşturmaya izin vermez. Arka planda OpenGL çağrıları yapmayı deneyen uygulamalar iOS tarafından sonlandırılır. Android, uygulamaları arka planda OpenGLES çağrıları veya ses yürütme gibi diğer arka plan görevlerini gerçekleştirme konusunda kısıtlamaz. swf sürümü 22 ve üstünde, AIR mobil uygulamaları renderMode direct (doğrudan) ayarlı olduğunda arka planda yürütülebilir. OpenGLES çağrıları arka planda yapılırsa AIR iOS çalışma zamanı bir ActionScript hatası ile sonuçlanır (3768 - Stage3D API'si arka planda yürütme sırasında kullanılmayabilir). Ancak, yerel uygulamalarına arka planda OpenGLES çağrıları yapma izni verildiğinden Android'de hata olmaz. Mobil kaynağın en iyi şekilde kullanımı için arka planda uygulama yürütülürken oluşturma çağrıları yapmayın.
Bu özellik AIR iOS ve Android'de desteklenir.
Uygulama
public function get executeInBackground():Boolean public function set executeInBackground(value:Boolean):void icon | özellik |
icon:InteractiveIcon [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Uygulama simgesi.
Simge sınıfını belirlemek için NativeApplication.supportsDockIcon ve NativeApplication.supportsSystemTrayIcon öğelerini kullanın. Türü, InteractiveIcon öğesinin alt sınıflarından biri olacaktır. Mac® OS X'te, NativeApplication.icon, DockIcon türünde bir nesnedir. Windows®'da NativeApplication.icon, SystemTrayIcon türünde bir nesne olacaktır. Bir uygulama simgesi desteklenmediğinde, NativeApplication.supportsDockIcon ve NativeApplication.supportsSystemTrayIcon öğelerinin her ikisi de false olur ve icon özelliği de null olur.
icon nesnesi otomatik olarak oluşturulur, ancak görüntü verileri ile birlikte başlatılmaz. Mac OS X gibi bazı işletim sistemlerinde varsayılan bir görüntü sağlanır. Windows gibi diğer işletim sistemlerinde, kendisine görüntü verisi atanmadığı sürece simge görüntülenmez. Simge görüntüsü atamak için, icon.bitmaps özelliğini en az bir BitmapData nesnesi içeren dizi ile ayarlayın. Dizide birden fazla BitmapData nesnesi varsa işletim sistemi, görüntülerden simgenin görüntü boyutlarına en yakın boyutta olanını, gerekirse görüntüyü ölçekleyerek seçer.
Uygulama
public function get icon():InteractiveIconİlgili API Öğeleri
idleThreshold | özellik |
idleThreshold:int| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
userIdle olayı gönderilmeden önce kullanıcı girdisi olmadan geçmesi gereken saniye sayısı.
Boşta kalma eşiği varsayılan olarak 300 saniyedir (5 dakika). Kabul edilebilir değer aralığı 5 (5 saniye) ile 86.400 (1 gün) değerleri de dahil olmak üzere bu iki değer arasıdır.
Uygulama
public function get idleThreshold():int public function set idleThreshold(value:int):voidAtar
ArgumentError — Özelliği geçersiz bir değere ayarlamaya çalışırsanız. Kabul edilebilir değer aralığı 5 (5 saniye) ile 86.400 (1 gün) değerleri de dahil olmak üzere bu iki değer arasıdır.
|
İlgili API Öğeleri
isCompiledAOT | özellik |
isCompiledAOT:Boolean [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 25.0 |
Uygulamanın istenen platform için derlendiğini veya yorumlandığını belirtir. Bu API, iOS'ta yalnızca hedefler için (ipa-app-store, ipa-test, ipa-debug, ipa-ad-hoc) (true) değerini döndürür. Diğer AIR platformları için bu API (false) değerini döndürür.
Uygulama
public function get isCompiledAOT():Boolean menu | özellik |
menu:NativeMenu| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Uygulama menüsü.
NativeApplication.supportsMenu değeri true olduğunda uygulama menüleri desteklenir. Tüm işletim sistemleri, uygulama menülerini desteklemez. Örneğin, uygulama menüleri Mac OS X'te desteklenir, ancak Windows veya Linux'ta desteklenmez. NativeApplication.supportsMenu değeri false olduğunda bu özelliğe bir NativeMenu nesnesi atanmasına izin verilir, ancak bir işe yaramaz. İşletim sisteminin uygulama menülerini destekleyip desteklemediğini belirlemek için NativeApplication.supportsMenu özelliğini kullandığınızdan emin olun. Desteği belirlemek için diğer araçların (örn. Capabilities.os) kullanılması, programlama hatalarına yol açabilir (bazı olası hedef işletim sistemleri dikkate alınmazsa).
AIR profili desteği: Bu özellik mobil aygıtlarda ve AIR for TV aygıtlarında desteklenmez. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.
Not:Mac OS X'te menu özelliği, işletim sistemi tarafından sağlanan varsayılan uygulama menüsüne başvurur. Varolan menü yapısını öğeler, alt menüler ekleyerek veya çıkararak veya olay dinleyicileri ekleyerek değiştirebilirsiniz. Ayrıca bu menu özelliğine yeni bir NativeMenu nesnesi atayarak varsayılan menüleri tamamen değiştirebilirsiniz.
Uygulama
public function get menu():NativeMenu public function set menu(value:NativeMenu):voidİlgili API Öğeleri
nativeApplication | özellik |
nativeApplication:NativeApplication [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
NativeApplication nesnesinin tekil örneği.
Uygulama
public static function get nativeApplication():NativeApplicationAtar
Error — Uygulama güvenliği sanal alanı dışındaki içerik tarafından erişilmesi durumunda.
|
openedWindows | özellik |
publisherID | özellik |
publisherID:String [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Bu uygulamanın yayıncı kimliği.
Bu kimliğin değeri, uygulamayı imzalamak için kullanılan ve yükleme sırasında sertifika zincirinden oluşturulan uygulamanın yayıncı kimliği dosyasında ayarlanır.
Uygulama
public function get publisherID():String runtimePatchLevel | özellik |
runtimeVersion | özellik |
startAtLogin | özellik |
startAtLogin:Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Geçerli kullanıcı her oturum açtığında bu uygulamanın otomatik olarak başlatılıp başlatılmayacağını belirtir.
AIR profili desteği: Bu özellik tüm masaüstü işletim sistemlerinde desteklenir ancak mobil aygıtlarda veya AIR for TV aygıtlarında desteklenmez. Desteği çalışma zamanında NativeApplication.supportsStartAtLogin özelliğini kullanarak test edebilirsiniz. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.
startAtLogin özelliği, kullanıcı oturum açtığında uygulamanın başlaması gerektiğini belirtmek için işletim sistemi tarafından tanımlanan mekanizmanın durumunu yansıtır. Kullanıcı, işletim sistemi kullanıcı arabirimini kullanarak durumu elle değiştirebilir. Bu özellik, durumun en son AIR uygulaması veya işletim sistemi tarafından değiştirilmesinden bağımsız olarak geçerli durumu yansıtır.
Uygulama
public function get startAtLogin():Boolean public function set startAtLogin(value:Boolean):voidAtar
IllegalOperationError — Windows'da, bu kullanıcı oturum açtığında, aynı adlı başka bir uygulama (ancak çalıştırılabilir öğeye giden farklı bir yolla) zaten başlatılmak üzere ayarlanmışsa.
| |
IllegalOperationError — Bu uygulama yüklü değilse, bu durum AIR Hata Ayıklama Başlatıcısı (ADL) tarafından başlatıldığında meydana gelebilir.
|
İlgili API Öğeleri
supportsDefaultApplication | özellik |
supportsDefaultApplication:Boolean [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 2 |
setAsDefaultApplication(), removeAsDefaultApplication() ve isSetAsDefaultApplication() öğelerinin geçerli platformda desteklenip desteklenmediğini gösterir.
Değer true ise yukarıdaki yöntemler belgelendikleri şekilde çalışır. Değer false ise setAsDefaultApplication() ve removeDefaultApplication() öğeleri hiçbir işlem gerçekleştirmez ve isSetAsDefaultApplication() öğesi false değerini döndürür.
Uygulama
public static function get supportsDefaultApplication():Booleanİlgili API Öğeleri
supportsDockIcon | özellik |
supportsDockIcon:Boolean [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
AIR'nin geçerli işletim sisteminde simge seti stilinde uygulama simgelerini destekleyip desteklemediğini belirtir.
true olursa, NativeApplication.icon özelliği, DockIcon türünde olur.
Mac OS X kullanıcı arabirimi, çalışan veya sık kullanılan uygulamaların simgelerini içeren bir uygulama "simge seti" sağlar.
İşletim sisteminin uygulama simge seti simgelerini destekleyip desteklemediğini belirlemek için NativeApplication.supportsDockIcon özelliğini kullandığınızdan emin olun. Desteği belirlemek için diğer araçların (örn. Capabilities.os) kullanılması, programlama hatalarına yol açabilir (bazı olası hedef işletim sistemleri dikkate alınmazsa).
Uygulama
public static function get supportsDockIcon():Booleanİlgili API Öğeleri
supportsMenu | özellik |
supportsMenu:Boolean [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Geçerli işletim sisteminin global uygulama menüsü çubuğunu destekleyip desteklemediğini belirtir.
true değerinde olduğunda NativeApplication.menu özelliği, yerli uygulama menüsünü tanımlamak (veya menüye erişmek) için kullanılır.
İşletim sisteminin uygulama menü çubuğunu destekleyip desteklemediğini belirlemek için NativeApplication.supportsMenu özelliğini kullandığınızdan emin olun. Desteği belirlemek için diğer araçların (örn. Capabilities.os) kullanılması, programlama hatalarına yol açabilir (bazı olası hedef işletim sistemleri dikkate alınmazsa).
Uygulama
public static function get supportsMenu():Booleanİlgili API Öğeleri
supportsStartAtLogin | özellik |
supportsStartAtLogin:Boolean [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 2 |
startAtLogin öğesinin geçerli platformda desteklenip desteklenmediğini belirtir.
Değer true ise, startAtLogin belgelendiği şekilde çalışır. Değer false ise, startAtLogin etkisizdir.
Uygulama
public static function get supportsStartAtLogin():Booleanİlgili API Öğeleri
supportsSystemTrayIcon | özellik |
supportsSystemTrayIcon:Boolean [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
AIR'nin geçerli işletim sisteminde sistem tepsisi simgelerini destekleyip desteklemediğini belirtir.
true değerindeyse, NativeApplication.icon özelliği, SystemTrayIcon türünde olur.
Windows kullanıcı arabirimi, resmi olarak uygulama simgelerinin görüntülenebildiği Bildirim Alanı adı verilen görev çubuğunun "sistem tepsisi" bölgesini sağlar. Varsayılan bir simge gösterilmez. Bir simgeyi görüntülemek için icon nesnesinin bitmaps dizisini ayarlamanız gerekir.
İşletim sisteminin sistem tepsisi simgelerini destekleyip desteklemediğini belirlemek için NativeApplication.supportsSystemTrayIcon özelliğini kullandığınızdan emin olun. Desteği belirlemek için diğer araçların (örn. Capabilities.os) kullanılması, programlama hatalarına yol açabilir (bazı olası hedef işletim sistemleri dikkate alınmazsa).
Uygulama
public static function get supportsSystemTrayIcon():Booleanİlgili API Öğeleri
systemIdleMode | özellik |
systemIdleMode:String| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 2 |
Uygulamaların kullanıcı arabiriminin "boşta kalma" moduna geçmesini önlemesine olanak tanır.
SystemIdleMode sınıfından, ana bilgisayar sisteminin boşta kalma modu davranışını etkileyecek bir değer. Bu özellik yalnızca girdi odaklı uygulama için etkilidir ve özelliğe yalnızca uygulama sanal alanında çalışan içerikten erişilebilir.
AIR profil desteği: Bu özellik mobil aygıtlarda desteklenir ancak masaüstü işletim sistemlerinde ve AIR for TV aygıtlarında desteklenmez. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.
Uygulama
public function get systemIdleMode():String public function set systemIdleMode(value:String):voidİlgili API Öğeleri
timeSinceLastUserInput | özellik |
activate | () | yöntem |
public function activate(window:NativeWindow = null):void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Bu uygulamayı etkinleştirir.
Bu yöntem NativeWindow sınıfını desteklemeyen platformlarda desteklenmez.
İşletim sistemi tarafından belirlenen şartlar altında bu yöntem, bir uygulamayı etkinleştirmez. Çoğu işletim sistemi, bir uygulamanın, kullanıcının diğer uygulamaları kullanmasını kazara veya kasıtlı olarak imkansız hale getirmesini önlemek üzere kendini etkinleştirme yeteneğini kısıtlar.
İşletim sistemi etkinleştirmeye izin veriyorsa, belirtilen pencere etkinleştirilir ve masaüstünde ön plana, yani diğer uygulama pencerelerinin önüne getirilir. (window parametresi null olursa, bu uygulamanın görünür bir penceresi etkinleştirilir.)
Uygulamanın görünür pencereleri yoksa activate() öğesinin hiçbir etkisi yoktur.
Etkinleştirme işlemi eşzamanlıdır.
Parametreler
window:NativeWindow (default = null) — Pencerenin, uygulamayla birlikte etkinleştirmek için kullanılan NativeWindow nesnesi.
|
Olaylar
activate: — Etkinleştirme durumu değişirse gönderilir.
|
addEventListener | () | yöntem |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void| Çalışma Zamanı Sürümleri: | AIR 1.0 |
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. Belirli türde bir olay, aşama ve öncelik için görüntüleme listesindeki tüm düğümlere olay dinleyicilerini kaydedebilirsiniz.
Bir olay dinleyicisini başarıyla kaydettikten sonra, addEventListener() öğesine ek çağrılar yaparak önceliğini değiştiremezsiniz. Bir dinleyicinin önceliğini değiştirmek için, ilk olarak removeListener() öğesini çağırmanız gerekir. Daha sonra dinleyiciyi yeni öncelik seviyesiyle kaydedebilirsiniz.
Dinleyici kaydedildikten sonra, farklı bir type veya useCapture değeriyle addEventListener() öğesine yapılan çağrılar, ayrı bir dinleyici kaydının oluşturulmasıyla sonuçlanır. Örneğin, ilk olarak useCapture true değerine ayarlanmış durumdayken bir dinleyiciyi kaydederseniz, dinleyici yalnızca yakalama aşaması boyunca dinleme işlemi yapar. Aynı dinleyici nesnesini kullanarak, ancak useCapture false değerine ayarlanmış durumdayken tekrar addEventListener() öğesini çağırırsanız, iki ayrı dinleyiciniz olur: bunlardan biri yakalama aşamasında dinleme işlemi yapar, diğeri ise hedef ve köpürme aşamasında dinleme işlemi yapar.
Yalnızca hedef aşaması veya köpürme aşaması için bir olay dinleyicisini kaydedemezsiniz. Köpürme yalnızca hedef düğümün alt öğeleri için geçerli olduğundan, bu aşamalar kayıt sırasında birleştirilir.
Artık bir olay dinleyicisine ihtiyacınız olmadığında, removeEventListener() öğesini çağırarak olay dinleyicisini kaldırın, aksi takdirde bellek sorunları oluşabilir. Çöp toplayıcısı, gönderen nesne var olduğu sürece dinleyiciyi kaldırmadığından, (useWeakReference parametresi true olarak ayarlı değilse) olay dinleyicileri otomatik olarak bellekten kaldırılmaz.
Bir EventDispatcher örneği kopyalandığında, o örneğe ekli olan olay dinleyicileri kopyalanmaz. (Yeni oluşturulmuş düğümünüz için bir olay dinleyicisi gerekiyorsa, düğümü oluşturduktan sonra dinleyiciyi eklemeniz gerekir.) Ancak bir EventDispatcher örneğini taşırsanız, örneğe ekli olan olay dinleyicileri de onunla birlikte taşınır.
Bir olay düğümde işlenirken olay dinleyicisi o düğüme kaydediliyorsa, geçerli aşama sırasında olay dinleyicisi tetiklenmez ancak olay akışındaki köpürme aşaması gibi sonraki bir aşamada tetiklenebilir.
Bir olay düğümde işlenirken olay dinleyicisi o düğümden kaldırılırsa, geçerli eylemler tetiklenmeye devam eder. Olay dinleyicisi kaldırıldıktan sonra asla tekrar çağrılmaz (ileride işlenmek üzere tekrar kaydedilmediği sürece).
Parametreler
type:String — Olay türü.
| |
listener:Function — Olayı işleyen dinleyici işlevi. Bu işlev, bu örnekte gösterildiği gibi, Event nesnesini tek parametresi olarak kabul etmeli ve hiçbir öğe döndürmemelidir:
function(evt:Event):void İşleve herhangi bir ad verilebilir. | |
useCapture:Boolean (default = false) —
Dinleyicinin yakalama aşamasında mı, yoksa hedef ve köpürme aşamalarında mı çalıştığını belirler. useCapture, true olarak ayarlanırsa dinleyici, olayı hedef veya köpürme aşamasında değil de yalnızca yakalama aşamasında işler. useCapture false değerindeyse dinleyici, olayı yalnızca hedef veya köpürme aşamasında işler. Olayı üç aşamada da dinlemek için addEventListener öğesini iki kez, biri useCapture true değerine ayarlanmış olarak, diğeri de useCapture false değerine ayarlanmış olarak çağırın.
| |
priority:int (default = 0) — Olay dinleyicisinin öncelik düzeyi. Öncelik, işaretli 32 bit tam sayı tarafından atanır. Sayı ne kadar yüksekse, öncelik de o kadar yüksek olur. n önceliğine sahip tüm dinleyiciler, n-1 önceliğine sahip dinleyicilerden önce işlenir. İki veya daha fazla dinleyici aynı önceliği paylaşırsa, eklendikleri sıraya göre işlenirler. Varsayılan öncelik 0'dır.
| |
useWeakReference:Boolean (default = false) — Dinleyici başvurusunun güçlü mü, yoksa zayıf mı olduğunu belirler. Güçlü bir başvuru (varsayılan), dinleyicinizin çöp toplama işlemine tabi tutulmasını önler. Zayıf bir başvuru, bu işlevi yapmaz. Sınıf düzeyi üye işlevleri, çöp toplama işlemine tabi değildir. Böylece onları çöp toplama işlemine tabi tutmadan, sınıf düzeyi üye işlevleri için |
clear | () | yöntem |
public function clear():Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Odaklanan görüntüleme nesnesine harici bir silme komutu çağırır.
Bu işlev çağrısı, odaklanılan nesnenin komutu uygulamaması durumunda yok sayılır. Yalnızca TextField veya HTMLLoader sınıflarından azalan görüntüleme nesneleri, geçerli olarak bu komutu uygular.
Not: clear() komutu seçilen metni siler. Seçilen herhangi bir öğe yoksa metnin tamamı temizlenmez.
Boolean — true.
|
copy | () | yöntem |
public function copy():Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Odaklanan görüntüleme nesnesine harici bir kopya komutu çağırır.
Bu işlev çağrısı, bileşenin komutu uygulamaması durumunda yok sayılır. Yalnızca TextField veya HTMLLoader sınıflarından azalan görüntüleme nesneleri, geçerli olarak bu komutu uygular.
DöndürürBoolean |
cut | () | yöntem |
public function cut():Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Odaklanan görüntüleme nesnesine harici bir kesme komutu çağırır.
Bu işlev çağrısı, bileşenin komutu uygulamaması durumunda yok sayılır. Yalnızca TextField veya HTMLLoader sınıflarından azalan görüntüleme nesneler,i geçerli olarak bu komutları uygular.
DöndürürBoolean — true.
|
dispatchEvent | () | yöntem |
override public function dispatchEvent(event:Event):Boolean| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Olay akışına bir olay gönderir. Olay hedefi, dispatchEvent() yönteminin çağrıldığı EventDispatcher nesnesidir.
Parametreler
event:Event — Olay akışına gönderilen Event nesnesi. Olay yeniden gönderiliyorsa, olayın bir klonu otomatik olarak oluşturulur. Bir olay gönderildikten sonra, o olaya ait target özelliği değiştirilemez, böylece işe yeniden göndermek üzere olayın yeni bir kopyasını çıkarmanız gerekir.
|
Boolean — Olayın başarılı bir şekilde gönderilmesi durumunda true değeri. false değeri, hata olduğunu veya preventDefault() öğesinin olayda çağrıldığını gösterir.
|
exit | () | yöntem |
public function exit(errorCode:int = 0):void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Bu uygulamayı sonlandırır.
exit() yöntemine yapılan çağrı, geri dönecektir; kapatma sırası, çalışmakta olan kod (geçerli olay işleyicisi gibi) tamamlanana kadar başlamaz. Bekleyen eşzamansız işlemler iptal edilir, tamamlanabilir veya tamamlanamaz.
Bir exiting olayının gönderilmediğini unutmayın. Bir exiting olayı, uygulama mantığı için gerekiyorsa, NativeApplication.nativeApplication.dispatchEvent() öğesini exiting türünde bir Event nesnesi ileterek çağırın. Herhangi bir açık pencere için, NativeWindow nesneleri closing ve close olaylarını gönderir. closing event nesnesinin preventDefault() yöntemini çağırmak uygulamadan çıkılmasını önler.
Not: Bu yöntem iOS işletme sisteminde desteklenmez.
Parametreler
errorCode:int (default = 0) — Bu uygulamadan çıkıldığında işletim sistemine bildirilen çıkış kodu.
|
getDefaultApplication | () | yöntem |
public function getDefaultApplication(extension:String):String| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Belirtilen uzantıya sahip dosyaları açmak için varsayılan uygulamayı alır.
Not: Bu yöntem yalnızca uygulama açıklayıcısının fileTypes ifadesinde bildirilen dosya türleriyle birlikte kullanılır.
Bu yöntem AIR for TV aygıtları için uygun değildir. Uygulama açıklamasında bildirilen bir dosya türü ile çağırırsanız null değerini döndürür.
Parametreler
extension:String — İlgilenilen dosya tipi uzantısını içeren bir String ("." olmadan).
|
String — Varsayılan uygulamanın yolu.
|
Atar
Error — extension parametresi, uygulama açıklayıcısında bildirilen dosya uzantılarından birini içermiyorsa.
|
İlgili API Öğeleri
isSetAsDefaultApplication | () | yöntem |
public function isSetAsDefaultApplication(extension:String):Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Bu uygulamanın, dosyaları belirtilen uzantıyla açmak için kullanılan geçerli varsayılan uygulama olup olmadığını belirtir.
AIR profili desteği: Bu özellik tüm masaüstü işletim sistemlerinde desteklenir ancak mobil aygıtlarda veya AIR for TV aygıtlarında desteklenmez. Desteği çalışma zamanında NativeApplication.supportsDefaultApplication özelliğini kullanarak test edebilirsiniz. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.
Parametreler
extension:String — İlgilenilen dosya tipi uzantısını içeren bir String ("." olmadan).
|
Boolean — bu uygulama varsayılan ise true değerindedir.
|
Atar
Error — extension parametresi, uygulama açıklayıcısında bildirilen dosya uzantılarından birini içermiyorsa.
|
İlgili API Öğeleri
paste | () | yöntem |
public function paste():Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Odaklanan görüntüleme nesnesine harici bir yapıştırma komutu çağırır.
Bu işlev çağrısı, bileşenin komutu uygulamaması durumunda yok sayılır. Yalnızca TextField veya HTMLLoader sınıflarından azalan görüntüleme nesneleri, geçerli olarak bu komutu uygular.
DöndürürBoolean — true.
|
removeAsDefaultApplication | () | yöntem |
public function removeAsDefaultApplication(extension:String):void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Bu uygulamayı, dosyaları belirtilen uzantıyla açmak için kullanılan varsayılan olarak kaldırır.
Not: Bu yöntem yalnızca uygulama açıklayıcısındaki fileTypes ifadesinde listelenen dosya türleriyle birlikte kullanılır.
Parametreler
extension:String — İlgilenilen dosya tipi uzantısını içeren bir String ("." olmadan).
|
Atar
Error — extension parametresi, uygulama açıklayıcısında bildirilen dosya uzantılarından birini içermiyorsa
|
İlgili API Öğeleri
removeEventListener | () | yöntem |
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void| Çalışma Zamanı Sürümleri: | AIR 1.0 |
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. EventDispatcher nesnesiyle kayıtlı eşlenen bir dinleyici yoksa, bu yönteme yapılan çağrının herhangi bir etkisi yoktur.
Parametreler
type:String — Olay türü.
| |
listener:Function — Kaldırılacak dinleyici nesnesi.
| |
useCapture:Boolean (default = false) —
Dinleyicinin yakalama aşaması için mi yoksa hedef ve köpürme aşamaları için mi kaydedildiğini belirtir. Dinleyici, hem yakalama aşaması hem de hedef ve köpürme aşamaları için kaydedildiyse, removeEventListener() öğesine yapılan iki çağrı, ikisini de kaldırmak için gereklidir. useCapture() öğesine sahip çağrılardan biri true, useCapture() öğesine sahip olan diğeri ise false olarak ayarlanmıştır.
|
selectAll | () | yöntem |
public function selectAll():Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Odaklanan görüntüleme nesnesine harici bir selectAll komutu çağırır.
Bu işlev çağrısı, bileşenin komutu uygulamaması durumunda yok sayılır. Yalnızca TextField veya HTMLLoader sınıflarından azalan görüntüleme nesneleri, geçerli olarak bu komutu uygular.
DöndürürBoolean — true.
|
setAsDefaultApplication | () | yöntem |
public function setAsDefaultApplication(extension:String):void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Bu uygulamayı, dosyaları belirtilen uzantıyla açmak için kullanılan varsayılan uygulama olarak ayarlar.
Not: Bu yöntem yalnızca uygulama açıklayıcısındaki fileTypes ifadesinde bildirilen dosya türleriyle birlikte kullanılır.
Parametreler
extension:String — İlgilenilen dosya tipi uzantısını içeren bir String ("." olmadan).
|
Atar
Error — extension parametresi, uygulama açıklayıcısında bildirilen dosya uzantılarından birini içermiyorsa
|
İlgili API Öğeleri
activate | Olay |
flash.events.Eventözellik Event.type =
flash.events.Event.ACTIVATE| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Bu uygulama etkin masaüstü uygulaması olduğunda gönderilir.
ACTIVATE sabiti, activate olay nesnesinin type özelliği değerini tanımlar.
Not: Bu olayda “yakalama aşaması“ veya “köpürme aşaması“ bulunmaz; başka bir deyişle, olay dinleyicileri her türlü potansiyel hedefe, hedefler görüntüleme listesinde olsun veya olmasın, doğrudan eklenmelidir.
AIR for TV aygıtları hiçbir zaman otomatik olarak bu olayı göndermez. Ancak olayı el ile gönderebilirsiniz.
Bu olay şu özelliklere sahiptir:
| Özellik | Değer |
|---|---|
bubbles | false |
cancelable | false; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | activate olayı için kayıtlı olan bir dinleyici içeren herhangi bir DisplayObject örneği. |
browserInvoke | Olay |
flash.events.BrowserInvokeEventözellik BrowserInvokeEvent.type =
flash.events.BrowserInvokeEvent.Browser_INVOKE| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Uygulama kullanıcının tarayıcısında çalışan bir SWF dosyası tarafından çağrıldığında gönderilir.
Yalnızca bir uygulama, uygulama açıklayıcı dosyasında aşağıdakileri belirtirse tarayıcı çağrısına izin verilir.
<allowBrowserInvocation>true</allowBrowserInvocation>
deactivate | Olay |
flash.events.Eventözellik Event.type =
flash.events.Event.DEACTIVATE| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Masaüstü odağı farklı bir uygulamaya geçirildiğinde gönderilir.
Event.DEACTIVATE sabiti, deactivate olay nesnesinin type özelliği değerini tanımlar.
Not: Bu olayda “yakalama aşaması“ veya “köpürme aşaması“ bulunmaz; başka bir deyişle, olay dinleyicileri her türlü potansiyel hedefe, hedefler görüntüleme listesinde olsun veya olmasın, doğrudan eklenmelidir.
AIR for TV aygıtları hiçbir zaman otomatik olarak bu olayı göndermez. Ancak olayı el ile gönderebilirsiniz.
Bu olay şu özelliklere sahiptir:
| Özellik | Değer |
|---|---|
bubbles | false |
cancelable | false; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | deactivate olayı için kayıtlı olan herhangi bir DisplayObject örneği. |
exiting | Olay |
flash.events.Eventözellik Event.type =
flash.events.Event.EXITING| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Uygulamanın çıkış sırası başlatıldığında gönderilir.
exiting olayı, uygulama çıkışı işletim sistemi tarafından başlatıldığında gönderilir; örneğin bir kullanıcı Mac OS X üzerinde Cmd-Q tuş sırasını kullandığında veya NativeApplication nesnesinin autoExit özelliği true olduğunda ve son uygulama penceresi kapatıldığında. Bu olayın iptal edilmesi, uygulamadan çıkılmasını engeller.
AIR for TV aygıtları asla exiting olayını göndermez.
Not: NativeApplication exit() yönteminin çağrılması, bir exiting olayının gönderilmesine neden olmaz. Yakında oluşabilecek bir çıkışın bileşenlerini uyarmak için, exit() öğesini çağırmadan önce exiting olayını gönderin.
Event.EXITINGsabiti, exiting olay nesnesinin type özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
| Özellik | Değer |
|---|---|
bubbles | false |
cancelable | true; bu olay nesnesinin iptal edilmesi durumunda çıkış işlemi durdurulur. |
currentTarget | NativeApplication nesnesi. |
target | NativeApplication nesnesi. |
invoke | Olay |
flash.events.InvokeEventözellik InvokeEvent.type =
flash.events.InvokeEvent.INVOKE| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Bir uygulama çağrıldığında gönderilir.
Bir uygulama ikinci kez çağrıldığında, uygulamanın başka bir örneği başlatılmaz. Bunun yerine ilk örnek, ek bir çağırma olayı alır. Sonra gelen invoke olaylarını uygun şekilde yönetmek, uygulamanın görevidir.
Not: Tüm invoke olayları sıradadır. Bu olayın bir dinleyicisi kaydedildiğinde, yeni olayların yanı sıra sıradaki tüm olayları da alır. Sıradaki olaylar, yeni invoke olaylarından önce veya sonra işleme sokulabilir.
InvokeEvent.INVOKE sabiti, InvokeEvent nesnesinin type özelliği değerini tanımlar.
InvokeEvent nesnesi şu özelliklere sahiptir:
| Özellikler | Değerler |
|---|---|
arguments | Bu çağrı sırasında iletilen string argümanları dizisi. |
currentDirectory | arguments dizisindeki ilgili yolları çözmek için kullanılması gereken dizini temsil eden bir File nesnesi. |
reason | invoke olayının gönderilmesindeki nedenin uygulamanın, oturum açma işleminde otomatik olarak başlaması mı (InvokeEventReason.LOGIN), uzaktan bir bildirime yanıt olarak başlaması mı (InvokeEventReason.NOTIFICATION - yalnızca iOS), uygulamanın başka bir uygulama tarafından çağrılması mı (InvokeEventReason.OPEN_URL), yoksa başka bir etken mi (InvokeEventReason.STANDARD) olduğunu belirten bir kod. AIR sürüm 1.5.1'den itibaren kullanılabilir. |
bubbles | false. |
cancelable | false; iptal edilecek varsayılan davranış yoktur. |
currentTarget | InvokeEvent nesnesini olay dinleyicisiyle etkin olarak işleyen nesneyi belirtir. |
target | Her zaman NativeApplication nesnesi. |
keyDown | Olay |
flash.events.KeyboardEventözellik KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Kullanıcı bir tuşa bastığında gönderilir. NativeApplication örneği, klavye hızlandırıcılarını desteklemek için bu olayı sağlar. Bu klavye olayı ilk önce NativeApplication öğesine gönderilir. Bu olayın iptal edilmesi, NativeWindow menü hızlandırıcılarını iptal eder. keyUp olayından önce bu olay gerçekleşir.
KeyboardEvent.KEY_DOWN sabiti, keyDown olay nesnesinin type özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
| Özellik | Değer |
|---|---|
bubbles | true |
cancelable | AIR'de true, Flash Player'da false; AIR'de bu olay iptal edildiğinde karakterin bir metin alanına girilmesi engellenir. |
charCode | Basılan veya bırakılan tuşun karakter kod değeri. |
commandKey | Mac'te Command tuşu etkinse true. Aksi takdirde, false |
controlKey | Ctrl tuşu etkin olduğunda Windows ve Linux'ta true. Mac'te Control tuşu etkinse true. Aksi takdirde, false |
ctrlKey | Ctrl tuşu etkin olduğunda Windows ve Linux'ta true. Ctrl veya Command tuşu etkin olduğunda Mac'te true. Aksi takdirde, false. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
keyCode | Basılan veya bırakılan tuşun tuş kod değeri. |
keyLocation | Tuşun klavyedeki konumu. |
shiftKey | Shift tuşu etkinse true; etkin değilse false. |
target | Odaklı InteractiveObject örneği target her zaman olay dinleyicisini kaydeden görüntüleme listesindeki nesne değildir. Geçerli olarak olayı işleyen görüntüleme listesindeki nesneye erişmek için currentTarget özelliğini kullanın. |
İlgili API Öğeleri
keyUp | Olay |
flash.events.KeyboardEventözellik KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Kullanıcı bir tuşu bıraktığında gönderilir. NativeApplication örneği, klavye hızlandırıcılarını desteklemek için bu olayı sağlar. Bu klavye olayı ilk önce NativeApplication öğesine gönderilir. Bu olayın iptal edilmesi, diğer nesneler üzerinde herhangi bir etki (örn. NativeWindow menü hızlandırıcıları) oluşturmaz. Bu olay, bir keyDown olayından sonra gerçekleşir.
KeyboardEvent.KEY_UP sabiti, keyUp olay nesnesinin type özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
| Özellik | Değer |
|---|---|
bubbles | true |
cancelable | false; iptal edilecek varsayılan davranış yoktur. |
charCode | Basılan veya bırakılan tuşun karakter kod değerini içerir. |
commandKey | Mac'te Command tuşu etkinse true. Aksi takdirde, false |
controlKey | Ctrl tuşu etkin olduğunda Windows ve Linux'ta true. Mac'te Control tuşu etkinse true. Aksi takdirde, false |
ctrlKey | Ctrl tuşu etkin olduğunda Windows'ta true. Ctrl veya Command tuşu etkin olduğunda Mac'te true. Aksi takdirde, false. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
keyCode | Basılan veya bırakılan tuşun tuş kod değeri. |
keyLocation | Tuşun klavyedeki konumu. |
shiftKey | Shift tuşu etkinse true; etkin değilse false. |
target | Odaklı InteractiveObject örneği target her zaman olay dinleyicisini kaydeden görüntüleme listesindeki nesne değildir. Geçerli olarak olayı işleyen görüntüleme listesindeki nesneye erişmek için currentTarget özelliğini kullanın. |
İlgili API Öğeleri
networkChange | Olay |
flash.events.Eventözellik Event.type =
flash.events.Event.NETWORK_CHANGE| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Yeni bir ağ bağlantısı kullanılabilir hale geldiğinde veya varolan ağ bağlantısı koptuğunda gönderilir.
Bir networkChange olayı mutlaka ana bilgisayarın çevrimiçi veya çevrimdışı olduğu anlamına gelmez; yalnızca bir tür bağlantıdan diğerine geçiş yapıyor olabilir. Uygulamalar bu olayı, uzak kaynak kullanılabilirliğini izleme görevini en iyileştirmek için kullanabilir. networkChange olayının gönderilmesi çoğu zaman uzak kaynakların kullanılabilirliğini doğrulamak için iyi bir zamandır.
Notlar:
- Ağdaki bir değişiklik ve bu olayın gönderimi arasında kısa bir gecikme olabilir.
- Android üzerinde NativeApplication nesnesi ağ bağlantısındaki her değişiklik için birden fazla networkChange olayı gönderebilir.
Event.NETWORK_CHANGE sabiti, networkChange 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. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | NativeApplication nesnesi. |
suspend | Olay |
flash.events.Eventözellik Event.type =
flash.events.Event.SUSPEND| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 3.3 |
Uygulama işletim sistemi tarafından askıya alınmak üzereyken gönderilir.
Event.SUSPEND sabiti suspend olayı nesnesinin type özelliği değerini tanımlar. Bu olay yalnızca AIR iOS'ta gönderilir.
Bu olay şu özelliklere sahiptir:
| Özellik | Değer |
|---|---|
bubbles | false |
cancelable | false; iptal edilecek varsayılan davranış yoktur. |
currentTarget | NativeApplication nesnesi. |
target | NativeApplication nesnesi. |
userIdle | Olay |
flash.events.Eventözellik Event.type =
flash.events.Event.USER_IDLE| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Kullanıcı boşta kaldığında gönderilir.
Bu olayın idleThreshold özelliği kullanılarak gönderilmesinden önce geçmesi gereken kullanıcının boşta kalma zamanını belirler. Kullanıcının boşta kaldığı süre miktarı, timeSinceLastUserInput özelliğinden belirlenebilir.
Not: Bu olay mobil aygıtlarda veya AIR for TV aygıtlarında gönderilmez.
Event.USER_IDLE sabiti, userIdle 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. |
target | NativeApplication nesnesi. |
İlgili API Öğeleri
userPresent | Olay |
flash.events.Eventözellik Event.type =
flash.events.Event.USER_PRESENT| Çalışma Zamanı Sürümleri: | AIR 1.0 |
İşletim sistemi, fareyi veya klavyeyi boşta geçen bir süre sonunda algıladığında gönderilir.
Not: Bu olay mobil aygıtlarda veya AIR for TV aygıtlarında gönderilmez.
Boşta geçtiği düşünülen zaman aralığı, idleThreshold özelliği ile konfigüre edilebilir. Kullanıcının boşta kaldığı süre miktarı, timeSinceLastUserInput özelliğinden belirlenebilir.
Event.USER_PRESENT sabiti, userPresent 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. |
target | NativeApplication nesnesi. |
İlgili API Öğeleri
Tue Jun 12 2018, 01:09 PM Z
Miras Alınan Genel Özellikleri Gizle
Miras Alınan Genel Özellikleri Göster