NativeApplication  - AS3

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.

Innehållet i programbeskrivningsfilen för det här AIR-programmet.

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);

Program-ID för det här programmet.

Värdet för detta ID anges i programbeskrivningsfilen.

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.

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.

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.

Relaterade API-element

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

Relaterade API-element

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

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.

Relaterade API-element

Hämtar singleton-instansen för NativeApplication-objektet.

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.

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.

Korrigeringsnivå för körningen som är värd för programmet.

Versionsnumret på körningen som är värd för programmet.

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.

Relaterade API-element

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.

Relaterade API-element

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

Relaterade API-element

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

Relaterade API-element

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.

Relaterade API-element

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

Relaterade API-element

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.

Relaterade API-element

Tiden, i sekunder, sedan senaste indata från användaren.

Relaterade API-element

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

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

function(evt:Event):void

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.

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.

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.

Skickar en händelse till händelseflödet. Händelsemålet är det EventDispatcher-objekt som dispatchEvent()-metoden anropas till.

Parametrar

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

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

Relaterade API-element

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

Relaterade API-element

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.

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

Relaterade API-element

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

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.

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

Relaterade API-element

Skickas när det här programmet blir det aktiva programmet på skrivbordet.

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:

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>

Skickas när skrivbordsfokus växlar till ett annat program.

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:

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.

Den här händelsen har följande egenskaper:

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-objektet har följande egenskaper:

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.

Den här händelsen har följande egenskaper:

Relaterade API-element

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.

Den här händelsen har följande egenskaper:

Relaterade API-element

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.

Den här händelsen har följande egenskaper:

Skickas när programmet är på väg att försättas i viloläge av operativsystemet.

Den här händelsen har följande egenskaper:

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.

Den här händelsen har följande egenskaper:

Relaterade API-element

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.

Den här händelsen har följande egenskaper:

Relaterade API-element