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? )
copyright
ve 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):void
Atar
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():NativeApplication
Atar
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):void
Atar
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.EXITING
sabiti, 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