| Paket | flash.desktop |
| Klass | public final class NativeApplication |
| Arv | NativeApplication  EventDispatcher Object |
| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
NativeApplication-klassen tillhandahåller programinformation, programövergripande funktioner och skickar händelser på programnivå.
NativeApplication-objektet är ett singleton-objekt, som skapas automatiskt när programmet startas. Hämta NativeApplication-instansen för ett program med den statiska egenskapen NativeApplication.nativeApplication.
Dölj ärvda publika egenskaper
Visa ärvda publika egenskaper| Egenskap | Definieras med | ||
|---|---|---|---|
| activeWindow : NativeWindow [skrivskyddad]
Det aktiva programfönstret. | NativeApplication | ||
| applicationDescriptor : XML [skrivskyddad]
Innehållet i programbeskrivningsfilen för det här AIR-programmet. | NativeApplication | ||
| applicationID : String [skrivskyddad]
Program-ID för det här programmet. | NativeApplication | ||
| autoExit : Boolean
Anger om programmet ska avslutas automatiskt när alla fönster har stängts. | NativeApplication | ||
 | constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | |
| executeInBackground : Boolean
Anger om programmet ska köras i bakgrunden eller inte. | NativeApplication | ||
| icon : InteractiveIcon [skrivskyddad]
Programikonen. | NativeApplication | ||
| idleThreshold : int
Anger hur många sekunder som ska förflyta utan användaråtgärder innan en userIdle-händelse skickas. | NativeApplication | ||
| isCompiledAOT : Boolean [skrivskyddad]
Anger om programmet kompileras eller tolkas för den önskade plattformen. | NativeApplication | ||
| menu : NativeMenu
Programmenyn. | NativeApplication | ||
| nativeApplication : NativeApplication [statisk] [skrivskyddad]
Hämtar singleton-instansen för NativeApplication-objektet. | NativeApplication | ||
| openedWindows : Array [skrivskyddad]
En array som innehåller programmets alla öppna inbyggda fönster. | NativeApplication | ||
| publisherID : String [skrivskyddad]
Utgivar-ID för det här programmet. | NativeApplication | ||
| runtimePatchLevel : uint [skrivskyddad]
Korrigeringsnivå för körningen som är värd för programmet. | NativeApplication | ||
| runtimeVersion : String [skrivskyddad]
Versionsnumret på körningen som är värd för programmet. | NativeApplication | ||
| startAtLogin : Boolean
Anger om det här programmet startas automatiskt när den aktuella användaren loggar in. | NativeApplication | ||
| supportsDefaultApplication : Boolean [statisk] [skrivskyddad]
Anger om setAsDefaultApplication(), removeAsDefaultApplication() och isSetAsDefaultApplication() stöds på den aktuella plattformen. | NativeApplication | ||
| supportsDockIcon : Boolean [statisk] [skrivskyddad]
Anger om AIR har stöd för programdockningsikoner i det aktuella operativsystemet. | NativeApplication | ||
| supportsMenu : Boolean [statisk] [skrivskyddad]
Anger om det aktuella operativsystemet har stöd för en global programmenyrad. | NativeApplication | ||
| supportsStartAtLogin : Boolean [statisk] [skrivskyddad]
Anger om startAtLogin stöds på den aktuella plattformen. | NativeApplication | ||
| supportsSystemTrayIcon : Boolean [statisk] [skrivskyddad]
Anger om AIR har stöd för aktivitetsfältsikoner i det aktuella operativsystemet. | NativeApplication | ||
| systemIdleMode : String
Används för att förhindra att användargränssnittet försätts i viloläge. | NativeApplication | ||
| timeSinceLastUserInput : int [skrivskyddad]
Tiden, i sekunder, sedan senaste indata från användaren. | NativeApplication | ||
| Metod | Definieras med | ||
|---|---|---|---|
Aktiverar det här programmet. | NativeApplication | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [åsidosätt]
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. | NativeApplication | ||
Anropar ett internt delete-kommando på det visningsobjekt som är i fokus. | NativeApplication | ||
Anropar ett internt copy-kommando på det visningsobjekt som är i fokus. | NativeApplication | ||
Anropar ett internt cut-kommando på det visningsobjekt som är i fokus. | NativeApplication | ||
[åsidosätt]
Skickar en händelse till händelseflödet. | NativeApplication | ||
Avslutar det här programmet. | NativeApplication | ||
Hämtar standardprogrammet för att öppna filer med det angivna tillägget. | NativeApplication | ||
|
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | EventDispatcher | |
|
Anger om det finns en egenskap angiven för ett objekt. | Object | |
|
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | |
Anger om det här programmet är aktuellt standardprogram för att öppna filer med angivet tillägg. | NativeApplication | ||
Anropar ett internt paste-kommando på det visningsobjekt som är i fokus. | NativeApplication | ||
|
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | |
Tar bort det här programmet som standardprogram för att öppna filer med angivet tillägg. | NativeApplication | ||
[åsidosätt]
Tar bort en avlyssnare från EventDispatcher-objektet. | NativeApplication | ||
Anropar ett internt selectAll-kommando på det visningsobjekt som är i fokus. | NativeApplication | ||
Anger det här programmet som standardprogram för att öppna filer med angivet tillägg. | NativeApplication | ||
|
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | |
|
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | |
|
Returnerar det angivna objektets strängbeteckning. | Object | |
|
Returnerar det angivna objektets primitiva värde. | Object | |
|
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. | EventDispatcher | |
| Händelse | Sammanfattning | Definieras med | ||
|---|---|---|---|---|
| Skickas när det här programmet blir det aktiva programmet på skrivbordet. | NativeApplication | |||
| Skickas när ett program anropas av en SWF-fil som körs i användarens webbläsare. | NativeApplication | |||
| Skickas när skrivbordsfokus växlar till ett annat program. | NativeApplication | |||
| Skickas när programavslutningssekvensen inleds. | NativeApplication | |||
| Skickas när ett program anropas. | NativeApplication | |||
| Skickas när användaren trycker på en tangent. | NativeApplication | |||
| Skickas när användaren släpper upp en tangent. | NativeApplication | |||
| Skickas när en ny nätverksanslutning blir tillgänglig eller när en befintlig nätverksanslutning bryts. | NativeApplication | |||
| Skickas när programmet är på väg att försättas i viloläge av operativsystemet. | NativeApplication | |||
| Skickas när användaren har varit inaktiv. | NativeApplication | |||
| Skickas när operativsystemet identifierar en mus- eller tangentbordsaktivitet efter en tids inaktivitet. | NativeApplication | |||
activeWindow | egenskap |
activeWindow:NativeWindow [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Det aktiva programfönstret.
Om det aktiva skrivbordsfönstret inte tillhör det här programmet, eller om det inte finns något aktivt fönster, är activeWindow null.
Den här egenskapen stöds inte på plattformar som saknar stöd för klassen NativeWindow.
Implementering
public function get activeWindow():NativeWindow applicationDescriptor | egenskap |
applicationDescriptor:XML [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Innehållet i programbeskrivningsfilen för det här AIR-programmet.
Implementering
public function get applicationDescriptor():XMLExempel ( Så här använder du exemplet )
copyright- och version-elementen från programbeskrivningsfilen. Tänk på att du måste använda det standardnamnutrymme som har definierats i programbeskrivningsfilen.
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 | egenskap |
autoExit | egenskap |
autoExit:Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anger om programmet ska avslutas automatiskt när alla fönster har stängts.
När autoExit har värdet true (standardvärdet) avslutas programmet när alla fönster har stängts. Både exiting- och exit-händelser skickas. När autoExit har värdet false måste du anropa NativeApplication.nativeApplication.exit() för att avsluta programmet.
Den här egenskapen stöds inte på plattformar som saknar stöd för klassen NativeWindow.
Implementering
public function get autoExit():Boolean public function set autoExit(value:Boolean):void executeInBackground | egenskap |
executeInBackground:Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 3.3 |
Anger om programmet ska köras i bakgrunden eller inte.
När executeInBackground är false, vilket är standardinställningen, förblir programmet i viloläge när det placeras i bakgrunden. När executeInBackground är true kan programmet köras i bakgrunden.
Obs! Med swf-version 21 och dess tidigare versioner har AIR inte stöd för bakgrundskörning på iOS och Android med återgivningsläget Direkt. På grund av den här begränsningen kan Stage3D-baserade program inte köra bakgrundsåtgärder som exempelvis ljuduppspelning, platsuppdateringar och nätverksöverföringar. iOS tillåter inte OpenGLES eller återgivningsanrop i bakgrunden. Program som försöker köra OpenGL-anrop i bakgrunden avslutas av iOS. Android begränsar inte program från att köra OpenGLES-anrop i bakgrunden eller från att köra andra bakgrundsåtgärder (som ljuduppspelning). Med swf-version 22 och senare kan AIR-mobilprogram köras i bakgrunden med återgivningsläget Direkt. AIR iOS-miljön genererar ett ActionScript-fel (3768 – Programmeringsgränssnittet för Stage3D kan inte användas under bakgrundskörning) om OpenGLES-anrop sker i bakgrunden. Däremot genereras inget fel på Android, eftersom Android-program tillåts köra OpenGLES-anrop i bakgrunden. För att utnyttja mobilresurserna optimalt bör återgivningsanrop inte ske när ett program körs i bakgrunden.
Den här egenskapen stöds på AIR iOS och Android.
Implementering
public function get executeInBackground():Boolean public function set executeInBackground(value:Boolean):void icon | egenskap |
icon:InteractiveIcon [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Programikonen.
Använd NativeApplication.supportsDockIcon och NativeApplication.supportsSystemTrayIcon för att fastställa icon-klassen. Typen är en av subklasserna i InteractiveIcon. På Mac® OS X är NativeApplication.icon ett objekt av DockIcon-typ. På Windows® är NativeApplication.icon ett objekt av SystemTrayIcon-typ. När en programikon inte stöds är både NativeApplication.supportsDockIcon och NativeApplication.supportsSystemTrayIcon false och egenskapen icon är null.
icon-objektet skapas automatiskt, men det initieras inte med bilddata. På vissa operativsystem, till exempel Mac OS X, visas en standardbild. På andra, till exempel Windows, visas inte ikonen om inga bilddata har tilldelats den. Om du vill tilldela en ikonbild ställer du in egenskapen icon.bitmaps på en array som innehåller minst ett BitmapData-objekt. Om fler än ett BitmapData-objekt inkluderas i arrayen används den bild som storleksmässigt bäst matchar ikonens visningsstorlek, och bilden skalas vid behov.
Implementering
public function get icon():InteractiveIconRelaterade API-element
idleThreshold | egenskap |
idleThreshold:int| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anger hur många sekunder som ska förflyta utan användaråtgärder innan en userIdle-händelse skickas.
Som standard är tröskelvärdet 300 sekunder (5 minuter). Giltiga värden är från 5 (5 sekunder) till och med 86 400 (1 dag).
Implementering
public function get idleThreshold():int public function set idleThreshold(value:int):voidUtlöser
ArgumentError — Om du försöker ställa in egenskapen på ett ogiltigt värde. Giltiga värden är från 5 (5 sekunder) till och med 86 400 (1 dag).
|
Relaterade API-element
isCompiledAOT | egenskap |
isCompiledAOT:Boolean [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 25.0 |
Anger om programmet kompileras eller tolkas för den önskade plattformen. Detta API returnerar bara (true) för iOS för målen (ipa-app-store, ipa-test, ipa-debug, ipa-ad-hoc). För andra AIR-plattformar returnerar detta API (false).
Implementering
public function get isCompiledAOT():Boolean menu | egenskap |
menu:NativeMenu| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Programmenyn.
Programmenyer stöds när NativeApplication.supportsMenu är true. Alla operativsystem har inte stöd för programmenyer. Programmenyer stöds till exempel på Mac OS X, men inte på Windows eller Linux. Du kan tilldela ett NativeMenu-objekt till den här egenskapen även om NativeApplication.supportsMenu är false, men det har då ingen effekt. Kom ihåg att använda egenskapen NativeApplication.supportsMenu för att avgöra om operativsystemet har stöd för programmenyer. Om du använder andra metoder (till exempel Capabilities.os) för att fastställa om stöd finns kan det ge upphov till programmeringsfel (om inte alla möjliga operativsystem beaktas).
Stöd för AIR-profiler: Den här funktionen stöds inte på mobilenheter eller enheter med AIR for TV. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.
Obs! På Mac OS X refererar egenskapen menu till den standardprogrammeny som hämtas från operativsystemet. Du kan ändra den befintliga menystrukturen genom att lägga till och ta bort objekt och undermenyer samt genom att lägga till händelseavlyssnare. Du kan också ersätta standardmenyerna helt genom att tilldela ett nytt NativeMenu-objekt till denna menu-egenskap.
Implementering
public function get menu():NativeMenu public function set menu(value:NativeMenu):voidRelaterade API-element
nativeApplication | egenskap |
nativeApplication:NativeApplication [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Hämtar singleton-instansen för NativeApplication-objektet.
Implementering
public static function get nativeApplication():NativeApplicationUtlöser
Error — Om innehåll utanför programmets säkerhetssandlåda försöker komma åt objektet.
|
openedWindows | egenskap |
openedWindows:Array [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
En array som innehåller programmets alla öppna inbyggda fönster.
Den här egenskapen stöds inte på plattformar som saknar stöd för klassen NativeWindow.
Implementering
public function get openedWindows():Array publisherID | egenskap |
publisherID:String [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Utgivar-ID för det här programmet.
Värdet för detta ID anges i programmets publisherid-fil, som genereras vid installationen från den certifikatkedja som används för att signera programmet.
Implementering
public function get publisherID():String runtimePatchLevel | egenskap |
runtimeVersion | egenskap |
startAtLogin | egenskap |
startAtLogin:Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anger om det här programmet startas automatiskt när den aktuella användaren loggar in.
Stöd för AIR-profiler: Den här funktionen stöds på alla operativsystem för datorer, men inte på mobilenheter eller enheter med AIR for TV. Du kan testa stödet vid körning med egenskapen NativeApplication.supportsStartAtLogin. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.
Egenskapen startAtLogin speglar statusen för den mekanism (som definieras av operativsystemet) som anger att ett program ska startas automatiskt när en användare loggar in. Användaren kan ändra statusen manuellt med operativsystemets gränssnitt. Den här egenskapen återspeglar den aktuella statusen, oavsett om den senast ändrades av AIR-programmet eller av operativsystemet.
Implementering
public function get startAtLogin():Boolean public function set startAtLogin(value:Boolean):voidUtlöser
IllegalOperationError — I Windows när ett annat program med samma namn (men med en annan sökväg till exe-filen) redan är inställt på att starta när den här användaren loggar in.
| |
IllegalOperationError — Om det här programmet inte är installerat, vilket kan vara fallet när det startas av AIR Debug Launcher (ADL).
|
Relaterade API-element
supportsDefaultApplication | egenskap |
supportsDefaultApplication:Boolean [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 2 |
Anger om setAsDefaultApplication(), removeAsDefaultApplication() och isSetAsDefaultApplication() stöds på den aktuella plattformen.
Om värdet är true fungerar ovanstående metoder i enlighet med dokumentationen. Om värdet är false utför setAsDefaultApplication() och removeDefaultApplication() ingenting, och isSetAsDefaultApplication() returnerar false.
Implementering
public static function get supportsDefaultApplication():BooleanRelaterade API-element
supportsDockIcon | egenskap |
supportsDockIcon:Boolean [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anger om AIR har stöd för programdockningsikoner i det aktuella operativsystemet.
Om värdet är true har egenskapen NativeApplication.icon typen DockIcon.
Användargränssnittet i Mac OS X har en "dock" som innehåller ikoner för program som körs eller används ofta.
Kom ihåg att använda egenskapen NativeApplication.supportsDockIcon för att avgöra om operativsystemet har stöd för programikoner i Dock. Om du använder andra metoder (till exempel Capabilities.os) för att fastställa om stöd finns kan det ge upphov till programmeringsfel (om inte alla möjliga operativsystem beaktas).
Implementering
public static function get supportsDockIcon():BooleanRelaterade API-element
supportsMenu | egenskap |
supportsMenu:Boolean [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anger om det aktuella operativsystemet har stöd för en global programmenyrad.
När värdet är true kan egenskapen NativeApplication.menu användas för att definiera (eller komma åt) en inbyggd programmeny.
Kom ihåg att använda egenskapen NativeApplication.supportsMenu för att avgöra om operativsystemet har stöd för programmenyfältet. Om du använder andra metoder (till exempel Capabilities.os) för att fastställa om stöd finns kan det ge upphov till programmeringsfel (om inte alla möjliga operativsystem beaktas).
Implementering
public static function get supportsMenu():BooleanRelaterade API-element
supportsStartAtLogin | egenskap |
supportsStartAtLogin:Boolean [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 2 |
Anger om startAtLogin stöds på den aktuella plattformen.
Om värdet är true fungerar startAtLogin i enlighet med dokumentationen. Om värdet är false har startAtLogin ingen effekt.
Implementering
public static function get supportsStartAtLogin():BooleanRelaterade API-element
supportsSystemTrayIcon | egenskap |
supportsSystemTrayIcon:Boolean [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anger om AIR har stöd för aktivitetsfältsikoner i det aktuella operativsystemet.
Om värdet är true har egenskapen NativeApplication.icon typen SystemTrayIcon.
Användargränssnittet i Windows har området "systemfältet" på aktivitetsfältet, officiellt kallat Notification Area, där programikoner kan visas. Ingen standardikon visas. Du måste ställa in arrayen bitmaps för ikonobjektet så att en ikon visas.
Kom ihåg att använda egenskapen NativeApplication.supportsSystemTrayIcon för att avgöra om operativsystemet har stöd för systemfältsikoner. Om du använder andra metoder (till exempel Capabilities.os) för att fastställa om stöd finns kan det ge upphov till programmeringsfel (om inte alla möjliga operativsystem beaktas).
Implementering
public static function get supportsSystemTrayIcon():BooleanRelaterade API-element
systemIdleMode | egenskap |
systemIdleMode:String| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 2 |
Används för att förhindra att användargränssnittet försätts i viloläge.
Ett värde från klassen SystemIdleMode som påverkar värdsystemets vilobeteende. Den här egenskapen är bara effektiv för det program som har indatafokus och kan bara nås från innehåll som körs i programsandlådan.
Stöd för AIR-profiler: Den här funktionen stöds på mobilenheter, men inte på operativsystem för datorer eller enheter med AIR for TV. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.
Implementering
public function get systemIdleMode():String public function set systemIdleMode(value:String):voidRelaterade API-element
timeSinceLastUserInput | egenskap |
activate | () | metod |
public function activate(window:NativeWindow = null):void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Aktiverar det här programmet.
Den här metoden stöds inte på plattformar som saknar stöd för klassen NativeWindow.
Under vissa förhållanden, som avgörs av operativsystemet, aktiverar den här metoden inte något program. De flesta operativsystem begränsar möjligheten för ett program att aktivera sig självt. Programmet hindras då från att låsa användargränssnittet så att användaren inte kan komma åt andra program.
Om operativsystemet tillåter aktivering så aktiveras det angivna fönstret och placeras överst på skrivbordet, d.v.s. framför andra programfönster. (Om parametern window är null aktiveras ett av de synliga fönstren i detta program.)
Metoden activate() har ingen effekt om programmet saknar synliga fönster.
Aktiveringsåtgärden är synkron.
Parametrar
window:NativeWindow (default = null) |
Händelser
activate: — Skickas om aktiveringsläget ändras.
|
addEventListener | () | metod |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void| Körningsmiljöversioner: | AIR 1.0 |
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. Du kan registrera händelseavlyssnare på alla noder i visningslistan efter en särskild typ av händelse, fas och prioritet.
När du har registrerat en händelseavlyssnare går det inte att ändra dess prioritet genom ytterligare anrop till addEventListener(). För att kunna ändra avlyssnarens prioritet måste du först anropa removeListener(). Sedan går det att registrera avlyssnaren på nytt med den nya prioritetsnivån.
Kom ihåg att när avlyssnaren har registrerats så skapar anrop till addEventListener() med annan type eller useCapture-värde en separat avlyssnarregistrering. Om du till exempel först registrerar en avlyssnare med useCapture inställt på true, avlyssnar den bara under hämtningsfasen. Om du anropar addEventListener() igen med samma avlyssningsobjekt men med useCapture inställt på false, får du två separata avlyssnare: en som avlyssnar under hämtningsfasen och en som avlyssnar under både mål- och bubblingsfasen.
Det går inte att registrera en händelseavlyssnare endast för målfasen eller bubblingsfasen. De faserna är sammankopplade vid registreringen eftersom bubblande bara tillämpas på de som är överordnade målnoden.
Om du inte längre behöver en händelseavlyssnare tar du bort den genom att anropa removeEventListener(). Annars finns risk för minnesproblem. Händelseavlyssnare tas inte automatiskt bort från minnet, eftersom skräpinsamlaren inte tar bort avlyssnaren så länge det skickande objektet finns (om inte parametern useWeakReference är true).
Kopiering av en EventDispatcher-instans innebär inte att de händelseavlyssnare som är kopplade till den kopieras. (Om en nod som du nyss skapat behöver en händelseavlyssnare måste du koppla avlyssnaren efter att du skapat noden.) Om du däremot flyttar en EventDispatcher-instans flyttas den kopplade händelseavlyssnaren med.
Om händelseavlyssnaren är registrerad på en nod samtidigt som en händelse bearbetas på den noden aktiveras inte händelseavlyssnaren under den aktuella fasen, men den kan aktiveras under en senare fas i händelseflödet, t.ex. bubblingsfasen.
Om en händelseavlyssnare tas bort från en nod samtidigt som en händelse bearbetas på den noden, aktiveras den ändå av de aktuella åtgärderna. När händelseavlyssnaren tagits bort anropas den aldrig mer (om den inte registreras på nytt för framtida bearbetning).
Parametrar
type:String — Händelsens typ.
| |
listener:Function — Avlyssnarfunktionen som bearbetar händelsen. Den här funktionen måste acceptera ett Event-objekt som sin enda parameter och får inte returnera någonting, se följande exempel:
function(evt:Event):void Funktionen kan ha vilket namn som helst. | |
useCapture:Boolean (default = false)useCapture är inställd på true bearbetar avlyssningsprocessen bara händelsen under hämtningsfasen och inte under mål- eller bubblingsfasen. Om useCapture är inställd på false bearbetar avlyssningsprocessen bara händelsen under mål- och bubblingsfasen. Om du vill avlyssna händelsen under alla tre faserna anropar du addEventListener två gånger, en gång med useCapture inställd på true, och sedan en gång med useCapture inställd på false.
| |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false)Medlemsfunktioner på klassnivå skräpsamlas inte, så du kan ange |
clear | () | metod |
public function clear():Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anropar ett internt delete-kommando på det visningsobjekt som är i fokus.
Det här funktionsanropet ignoreras om objektet som är i fokus inte implementerar kommandot. Just nu är det bara visningsobjekt som härrör från TextField- eller HTMLLoader-klasserna som implementerar det här kommandot.
Obs! Kommandot clear() raderar markerad text. Om ingenting markeras raderas inte all text.
Boolean — true.
|
copy | () | metod |
public function copy():Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anropar ett internt copy-kommando på det visningsobjekt som är i fokus.
Det här funktionsanropet ignoreras om komponenten inte implementerar kommandot. Just nu är det bara visningsobjekt som härrör från TextField- eller HTMLLoader-klasserna som implementerar det här kommandot.
ReturnerarBoolean |
cut | () | metod |
public function cut():Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anropar ett internt cut-kommando på det visningsobjekt som är i fokus.
Det här funktionsanropet ignoreras om komponenten inte implementerar kommandot. Just nu är det bara visningsobjekt som härrör från TextField- eller HTMLLoader-klasserna som implementerar det här kommandot.
ReturnerarBoolean — true.
|
dispatchEvent | () | metod |
override public function dispatchEvent(event:Event):Boolean| Körningsmiljöversioner: | AIR 1.0 |
Skickar en händelse till händelseflödet. Händelsemålet är det EventDispatcher-objekt som dispatchEvent()-metoden anropas till.
Parametrar
event:Event — Event-objektet som skickas till händelseflödet. En klon av händelsen skapas automatiskt om en händelse skickas om. När en händelse har skickats kan dess target-egenskap inte ändras. Du måste skapa en ny kopia av händelsen om du vill skicka om för arbete.
|
Boolean — Värdet true om händelsen skickades. Värdet false anger att det inte fungerade eller att preventDefault() anropades för händelsen.
|
exit | () | metod |
public function exit(errorCode:int = 0):void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Avslutar det här programmet.
Anropet till metoden exit() returnerar; avslutningssekvensen inleds inte förrän den kod som körs för tillfället (som en händelsehanterare) har slutförts. Väntande asynkrona åtgärder avbryts och kan antingen avslutas eller lämnas oavslutade.
Observera att ingen exiting-händelse skickas. Om programmet kräver att en exiting-händelse skickas anropar du NativeApplication.nativeApplication.dispatchEvent() och skickar ett Event-objekt av typen exiting. För alla öppna fönster skickar NativeWindow-objekt closing- och close-händelser. Om metoden preventDefault() för closing-händelseobjektet anropas kan programmet inte avslutas.
Obs! Den här metoden stöds inte på operativsystemet iOS.
Parametrar
errorCode:int (default = 0) |
getDefaultApplication | () | metod |
public function getDefaultApplication(extension:String):String| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Hämtar standardprogrammet för att öppna filer med det angivna tillägget.
Obs! Den här metoden kan bara användas med filtyper som har deklarerats i programsatsen fileTypes i programbeskrivningen.
Den här metoden kan inte användas på enheter med AIR for TV. Om du anropar den med en filtyp som deklarerats i programbeskrivningsfilen returneras null.
Parametrar
extension:String — En String som innehåller filtillägget för den aktuella filtypen (utan ”.”).
|
String — Sökväg till standardprogrammet.
|
Utlöser
Error — Om parametern extension inte innehåller något av de filtillägg som har deklarerats i programbeskrivningen.
|
Relaterade API-element
isSetAsDefaultApplication | () | metod |
public function isSetAsDefaultApplication(extension:String):Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anger om det här programmet är aktuellt standardprogram för att öppna filer med angivet tillägg.
Stöd för AIR-profiler: Den här funktionen stöds på alla operativsystem för datorer, men inte på mobilenheter eller enheter med AIR for TV. Du kan testa stödet vid körning med egenskapen NativeApplication.supportsDefaultApplication. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.
Parametrar
extension:String — En String som innehåller filtillägget för den aktuella filtypen (utan ”.”).
|
Boolean — true om det här programmet är standardprogrammet.
|
Utlöser
Error — Om parametern extension inte innehåller något av de filtillägg som har deklarerats i programbeskrivningen.
|
Relaterade API-element
paste | () | metod |
public function paste():Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anropar ett internt paste-kommando på det visningsobjekt som är i fokus.
Det här funktionsanropet ignoreras om komponenten inte implementerar kommandot. Just nu är det bara visningsobjekt som härrör från TextField- eller HTMLLoader-klasserna som implementerar det här kommandot.
ReturnerarBoolean — true.
|
removeAsDefaultApplication | () | metod |
public function removeAsDefaultApplication(extension:String):void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Tar bort det här programmet som standardprogram för att öppna filer med angivet tillägg.
Obs! Den här metoden kan bara användas med filtyper som listas i programsatsen fileTypes i programbeskrivningen.
Parametrar
extension:String — En String som innehåller filtillägget för den aktuella filtypen (utan ”.”).
|
Utlöser
Error — Om parametern extension inte innehåller något av de filtillägg som har deklarerats i programbeskrivningen.
|
Relaterade API-element
removeEventListener | () | metod |
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void| Körningsmiljöversioner: | AIR 1.0 |
Tar bort en avlyssnare från EventDispatcher-objektet. Ett anrop till den här metoden har ingen effekt om det inte finns någon matchande avlyssnare registrerad för EventDispatcher-objektet.
Parametrar
type:String — Händelsens typ.
| |
listener:Function — Det avlyssnarobjekt som ska tas bort.
| |
useCapture:Boolean (default = false)removeEventListener() för att båda ska tas bort: ett anrop med useCapture() inställt på true och ett annat anrop med useCapture() inställt på false.
|
selectAll | () | metod |
public function selectAll():Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anropar ett internt selectAll-kommando på det visningsobjekt som är i fokus.
Det här funktionsanropet ignoreras om komponenten inte implementerar kommandot. Just nu är det bara visningsobjekt som härrör från TextField- eller HTMLLoader-klasserna som implementerar det här kommandot.
ReturnerarBoolean — true.
|
setAsDefaultApplication | () | metod |
public function setAsDefaultApplication(extension:String):void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anger det här programmet som standardprogram för att öppna filer med angivet tillägg.
Obs! Den här metoden kan bara användas med filtyper som har deklarerats i programsatsen fileTypes i programbeskrivningen.
Parametrar
extension:String — En String som innehåller filtillägget för den aktuella filtypen (utan ”.”).
|
Utlöser
Error — Om parametern extension inte innehåller något av de filtillägg som har deklarerats i programbeskrivningen.
|
Relaterade API-element
activate | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.ACTIVATE| Körningsmiljöversioner: | AIR 1.0 |
Skickas när det här programmet blir det aktiva programmet på skrivbordet.
KonstantenACTIVATE definierar värdet för type-egenskapen för ett activate-händelseobjekt.
Obs! Den här händelsen har varken en ”capture phase” eller en ”bubble phase” vilket innebär att händelseavlyssnaren måste läggas till direkt i potentiella mål, oavsett om målet visas i listan eller inte.
Enheter med AIR for TV skickar aldrig den här händelsen automatiskt. Du kan skicka den manuellt om du vill.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Alla DisplayObject-instanser med en avlyssnare registrerad för activate-händelsen. |
browserInvoke | Händelse |
flash.events.BrowserInvokeEventegenskap BrowserInvokeEvent.type =
flash.events.BrowserInvokeEvent.Browser_INVOKE| Körningsmiljöversioner: | AIR 1.0 |
Skickas när ett program anropas av en SWF-fil som körs i användarens webbläsare.
Webbläsaranrop tillåts endast om programmet specificerar följande i programbeskrivningsfilen:
<allowBrowserInvocation>true</allowBrowserInvocation>
deactivate | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.DEACTIVATE| Körningsmiljöversioner: | AIR 1.0 |
Skickas när skrivbordsfokus växlar till ett annat program.
Event.DEACTIVATE-konstanten definierar värdet på type-egenskapen i ett deactivate-händelseobjekt.
Obs! Den här händelsen har varken en ”capture phase” eller en ”bubble phase” vilket innebär att händelseavlyssnaren måste läggas till direkt i potentiella mål, oavsett om målet visas i listan eller inte.
Enheter med AIR for TV skickar aldrig den här händelsen automatiskt. Du kan skicka den manuellt om du vill.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Alla DisplayObject-instanser med en avlyssnare registrerad för deactivate-händelsen. |
exiting | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.EXITING| Körningsmiljöversioner: | AIR 1.0 |
Skickas när programavslutningssekvensen inleds.
exiting-händelsen skickas när programavslutning inleds av operativsystemet, till exempel när användaren trycker på Cmd-Q på Mac OS X eller när autoExit-egenskapen i NativeApplication-objektet är true och det sista programfönstret stängs. Om den här händelsen avbryts avslutas programmet inte.
Enheter med AIR for TV skickar aldrig exiting-händelsen.
Obs! Anrop av NativeApplication-metoden exit() ger inte upphov till att en exiting-händelse skickas. Skicka exiting-händelsen innan exit() anropas för att varna komponenter om en nära förestående avslutning.
Event.EXITING-konstanten definierar värdet på type-egenskapen i ett exiting-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | true; att avbryta det här händelseobjektet innebär att exit-åtgärden avbryts. |
currentTarget | NativeApplication-objektet. |
target | NativeApplication-objektet. |
invoke | Händelse |
flash.events.InvokeEventegenskap InvokeEvent.type =
flash.events.InvokeEvent.INVOKE| Körningsmiljöversioner: | AIR 1.0 |
Skickas när ett program anropas.
När ett program anropas en andra gång startas inte en andra instans av programmet. Den första instansen tar i stället emot ytterligare en invoke-händelse. Programmet måste själv hantera efterföljande invoke-händelser korrekt.
Obs! Alla invoke-händelser köas. När en lyssnare registreras för den här händelsen tar den emot alla händelser i kön samt alla nya händelser. Köade händelser kan skickas före eller efter nya invoke-händelser.
InvokeEvent.OPEN-konstanten definierar värdet på type-egenskapen i ett InvokeEvent-objekt.
InvokeEvent-objektet har följande egenskaper:
| Egenskaper | Värden |
|---|---|
argument | Arrayen med strängargument som har skickats vid det här anropet. |
currentDirectory | ett File-objekt som representerar katalogen som ska användas för att lösa relativa sökvägar i arguments-arrayen. |
reason | kod som anger om invoke-händelsen skickades eftersom programmet startades automatiskt vid inloggning (InvokeEventReason.LOGIN), startades som svar på ett fjärrmeddelande (InvokeEventReason.NOTIFICATION – endast iOS), anropades av ett annat program (InvokeEventReason.OPEN_URL) eller startades av någon annan orsak (InvokeEventReason.STANDARD). Tillgänglig från och med AIR version 1.5.1. |
bubbles | false. |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Anger det objekt som aktivt behandlar InvokeEvent-objektet med en händelseavlyssnare. |
target | Alltid NativeApplication-objektet. |
keyDown | Händelse |
flash.events.KeyboardEventegenskap KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Skickas när användaren trycker på en tangent. Instansen NativeApplication tillhandahåller den här händelsen som stöd för kortkommandon. Den här tangentbordshändelsen skickas först till NativeApplication. Om du avbryter den här händelsen avbryts även NativeWindow-menykortkommandon. Denna händelse inträffar före keyUp-händelsen.
KeyboardEvent.KEY_DOWN-konstanten definierar värdet på type-egenskapen i ett keyDown-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | true |
cancelable | true i AIR, false i Flash Player. I AIR går det inte att skriva tecknet i ett textfält om händelsen avbryts. |
charCode | Innehåller värdet för teckenkoden för den senaste tangenten som trycktes ned eller släpptes upp. |
commandKey | true i Macintosh om Kommando-tangenten är aktiv. Annars false |
controlKey | true i Windows och Linux om Ctrl-tangenten är aktiv. true i Macintosh om Ctrl-tangenten är aktiv. Annars false |
ctrlKey | true i Windows och Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
keyCode | Innehåller värdet för tangentkoden för den senaste tangenten som trycktes ned eller släpptes upp. |
keyLocation | Tangentens placering på tangentbordet. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
target | Den InteractiveObject-instans som är i fokus. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
Relaterade API-element
keyUp | Händelse |
flash.events.KeyboardEventegenskap KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Skickas när användaren släpper upp en tangent. Instansen NativeApplication tillhandahåller den här händelsen som stöd för kortkommandon. Den här tangentbordshändelsen skickas först till NativeApplication. Om du avbryter den här händelsen påverkas inga andra objekt (till exempel NativeWindow-menykortkomandon). Den här händelsen inträffar efter en keyDown-händelse.
KeyboardEvent.KEY_UP-konstanten definierar värdet på type-egenskapen i ett keyUp-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | true |
cancelable | false; det finns inget standardbeteende att avbryta. |
charCode | Innehåller värdet för teckenkoden för den senaste tangenten som trycktes ned eller släpptes upp. |
commandKey | true i Macintosh om Kommando-tangenten är aktiv. Annars false |
controlKey | true i Windows och Linux om Ctrl-tangenten är aktiv. true i Macintosh om Ctrl-tangenten är aktiv. Annars false |
ctrlKey | true i Windows om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
keyCode | Innehåller värdet för tangentkoden för den senaste tangenten som trycktes ned eller släpptes upp. |
keyLocation | Tangentens placering på tangentbordet. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
target | Den InteractiveObject-instans som är i fokus. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
Relaterade API-element
networkChange | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.NETWORK_CHANGE| Körningsmiljöversioner: | AIR 1.0 |
Skickas när en ny nätverksanslutning blir tillgänglig eller när en befintlig nätverksanslutning bryts.
En networkChange-händelse betyder inte nödvändigtvis att värddatorn har kopplats upp eller ned. Den kan också betyda att anslutningsstypen håller på att förändras. Program kan använda den här händelsen för att optimera övervakning av olika fjärresursers tillgänglighet. Det är ofta lämpligt att kontrollera tillgängligheten för fjärresurser när en networkChange-händelse skickas.
Obs!
- Det kan uppstå en kort fördröjning mellan en nätverksförändring och den tidpunkt då händelsen skickas.
- På Android kan NativeApplication-objektet skicka fler än en networkChange-händelse för varje förändring i en nätverksanslutning.
Event.NETWORK_CHANGE-konstanten definierar värdet på type-egenskapen i ett networkChange-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | NativeApplication-objektet. |
suspend | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.SUSPEND| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 3.3 |
Skickas när programmet är på väg att försättas i viloläge av operativsystemet.
KonstantenEvent.SUSPEND definierar värdet för type-egenskapen för ett suspend-händelseobjekt. Denna händelse skickas endast med AIR iOS.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | NativeApplication-objektet. |
target | NativeApplication-objektet. |
userIdle | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.USER_IDLE| Körningsmiljöversioner: | AIR 1.0 |
Skickas när användaren har varit inaktiv.
Anger tidsperioden som en användare måste vara inaktiv innan händelsen skickas med egenskapen idleThreshold. Hur länge användaren har varit inaktiv kan utläsas av egenskapen timeSinceLastUserInput.
Obs! Den här händelsen skickas inte på mobilenheter eller enheter med AIR for TV.
Event.USER_IDLE-konstanten definierar värdet på type-egenskapen i ett userIdle-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
target | NativeApplication-objektet. |
Relaterade API-element
userPresent | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.USER_PRESENT| Körningsmiljöversioner: | AIR 1.0 |
Skickas när operativsystemet identifierar en mus- eller tangentbordsaktivitet efter en tids inaktivitet.
Obs! Den här händelsen skickas inte på mobilenheter eller enheter med AIR for TV.
Tidsgränsen för inaktivitet konfigureras med egenskapen idleThreshold. Hur länge användaren har varit inaktiv kan utläsas av egenskapen timeSinceLastUserInput.
Event.USER_PRESENT-konstanten definierar värdet på type-egenskapen i ett userPresent-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
target | NativeApplication-objektet. |
Relaterade API-element
Tue Jun 12 2018, 01:40 PM Z