Pakket | flash.desktop |
Klasse | public final class NativeApplication |
Overerving | NativeApplication EventDispatcher Object |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
De klasse NativeApplication biedt toepassingsinformatie, toepassingsbrede functies, en verzendt gebeurtenissen op toepassingsniveau.
Het NativeApplication-object is een singleton object dat automatisch bij het opstarten wordt gemaakt. Hiermee wordt de instantie NativeApplication van een toepassing met de statische eigenschap NativeApplication.nativeApplication
opgehaald.
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
activeWindow : NativeWindow [alleen-lezen]
Het actieve toepassingsvenster. | NativeApplication | ||
applicationDescriptor : XML [alleen-lezen]
De inhoud van het toepassingsbeschrijvingsbestand voor deze AIR-toepassing. | NativeApplication | ||
applicationID : String [alleen-lezen]
De toepassings-id van deze toepassing. | NativeApplication | ||
autoExit : Boolean
Geeft op of de toepassing automatisch moet worden afgesloten als alle vensters werden gesloten. | NativeApplication | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
executeInBackground : Boolean
Geeft aan of de toepassing al dan niet op de achtergrond wordt uitgevoerd. | NativeApplication | ||
icon : InteractiveIcon [alleen-lezen]
Het toepassingspictogram. | NativeApplication | ||
idleThreshold : int
Het aantal seconden zonder gebruikersinvoer dat is verstreken voordat een userIdle-gebeurtenis wordt verzonden. | NativeApplication | ||
isCompiledAOT : Boolean [alleen-lezen]
Geeft aan of de toepassing wordt gecompileerd of voor het gewenste platform wordt geïnterpreteerd. | NativeApplication | ||
menu : NativeMenu
Het toepassingsmenu. | NativeApplication | ||
nativeApplication : NativeApplication [statisch] [alleen-lezen]
De singleton instantie van het NativeApplication-object. | NativeApplication | ||
openedWindows : Array [alleen-lezen]
Een array die alle geopende eigen vensters van deze toepassing bevat. | NativeApplication | ||
publisherID : String [alleen-lezen]
De uitgevers-id van deze toepassing. | NativeApplication | ||
runtimePatchLevel : uint [alleen-lezen]
Het patchniveau van de runtime waarin deze toepassing wordt uitgevoerd. | NativeApplication | ||
runtimeVersion : String [alleen-lezen]
Het versienummer van de runtime waarin deze toepassing wordt uitgevoerd. | NativeApplication | ||
startAtLogin : Boolean
Geeft aan of de toepassing automatisch wordt gestart wanneer de huidige gebruiker zich aanmeldt. | NativeApplication | ||
supportsDefaultApplication : Boolean [statisch] [alleen-lezen]
Geeft aan of setAsDefaultApplication(), removeAsDefaultApplication() en isSetAsDefaultApplication() worden ondersteund op het huidige platform. | NativeApplication | ||
supportsDockIcon : Boolean [statisch] [alleen-lezen]
Geeft aan of op het huidige besturingssysteem Dock-pictogrammen voor toepassingen door AIR worden ondersteund. | NativeApplication | ||
supportsMenu : Boolean [statisch] [alleen-lezen]
Geeft aan of een algemene toepassingsmenubalk door het huidige besturingssysteem wordt ondersteund. | NativeApplication | ||
supportsStartAtLogin : Boolean [statisch] [alleen-lezen]
Geeft aan of startAtLogin op het huidige platform wordt ondersteund. | NativeApplication | ||
supportsSystemTrayIcon : Boolean [statisch] [alleen-lezen]
Geeft aan of op het huidige besturingssysteem systeemvakpictogrammen voor toepassingen door AIR worden ondersteund. | NativeApplication | ||
systemIdleMode : String
Biedt een manier waarop toepassingen kunnen voorkomen dat de gebruikersinterface overschakelt naar de modus Niet-actief. | NativeApplication | ||
timeSinceLastUserInput : int [alleen-lezen]
De tijd, in seconden, sinds de laatste gebruikersinvoer. | NativeApplication |
Methode | Gedefinieerd door | ||
---|---|---|---|
Activeert deze toepassing. | NativeApplication | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [overschrijven]
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | NativeApplication | ||
Roept een interne verwijderopdracht op het gefocuste weergaveobject aan. | NativeApplication | ||
Roept een interne kopieeropdracht op het gefocuste weergaveobject aan. | NativeApplication | ||
Roept een interne knipopdracht op het gefocuste weergaveobject aan. | NativeApplication | ||
[overschrijven]
Verzendt een gebeurtenis naar de gebeurtenisstroom. | NativeApplication | ||
Sluit de toepassing af. | NativeApplication | ||
Hiermee wordt de standaardtoepassing voor het openen van bestanden met de opgegeven extensie opgehaald. | NativeApplication | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Geeft aan of deze toepassing momenteel de standaardtoepassing is voor het openen van bestanden met de opgegeven extensie. | NativeApplication | ||
Roept een interne plakopdracht op het gefocuste weergaveobject aan. | NativeApplication | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Verwijdert deze toepassing als de standaardtoepassing voor het openen van bestanden met de opgegeven extensie. | NativeApplication | ||
[overschrijven]
Verwijdert een listener uit het object EventDispatcher. | NativeApplication | ||
Roept een interne opdracht selectAll op het gefocuste weergaveobject aan. | NativeApplication | ||
Stelt deze toepassing in als de standaardtoepassing voor het openen van bestanden met de opgegeven extensie. | NativeApplication | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher |
Gebeurtenis | Overzicht | Gedefinieerd door | ||
---|---|---|---|---|
Wordt verzonden als deze toepassing de actieve toepassing op het bureaublad wordt. | NativeApplication | |||
Wordt verzonden wanneer een toepassing wordt geactiveerd door een SWF-bestand dat in de browser van de gebruiker wordt uitgevoerd. | NativeApplication | |||
Wordt verzonden wanneer de focus van het bureaublad naar een andere toepassing wordt omgeschakeld. | NativeApplication | |||
Wordt verzonden als de afsluitprocedure van de toepassing wordt gestart. | NativeApplication | |||
Wordt verzonden wanneer de toepassing wordt aangeroepen. | NativeApplication | |||
Wordt verzonden wanneer de gebruiker op een toets drukt. | NativeApplication | |||
Wordt verzonden wanneer de gebruiker een toets loslaat. | NativeApplication | |||
Wordt verzonden als er een nieuwe netwerkverbinding beschikbaar wordt of als er een bestaande netwerkverbinding verloren gaat. | NativeApplication | |||
Verzonden wanneer de toepassing wordt onderbroken door het besturingssysteem. | NativeApplication | |||
Wordt verzonden als de gebruiker inactief is geweest. | NativeApplication | |||
Wordt verzonden wanneer het besturingssysteem na een periode zonder activiteit muis- of toetsenbordactiviteiten detecteert. | NativeApplication |
activeWindow | eigenschap |
activeWindow:NativeWindow
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Het actieve toepassingsvenster.
Als het actieve bureaubladvenster niet bij deze toepassing hoort of als er geen venster actief is, is activeWindow
null
.
Deze eigenschap wordt niet ondersteund op platforms die geen ondersteuning bieden voor de NativeWindow-klasse.
Implementatie
public function get activeWindow():NativeWindow
applicationDescriptor | eigenschap |
applicationDescriptor:XML
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
De inhoud van het toepassingsbeschrijvingsbestand voor deze AIR-toepassing.
Implementatie
public function get applicationDescriptor():XML
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
copyright
en version
uit het toepassingsbeschrijvingsbestand gelezen. Gebruik de standaardnaamruimte die in de XML-code van het toepassingsbeschrijvingsbestand is gedefinieerd.
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 | eigenschap |
autoExit | eigenschap |
autoExit:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Geeft op of de toepassing automatisch moet worden afgesloten als alle vensters werden gesloten.
Als de waarde van autoExit
true
is (dit is de standaardwaarde), wordt de toepassing afgesloten wanneer alle vensters worden gesloten. Er wordt zowel een exiting
-gebeurtenis als een exit
-gebeurtenis verzonden. Roep NativeApplication.nativeApplication.exit()
aan om de toepassing te sluiten als de waarde van autoExit
false
is.
Deze eigenschap wordt niet ondersteund op platforms die geen ondersteuning bieden voor de NativeWindow-klasse.
Implementatie
public function get autoExit():Boolean
public function set autoExit(value:Boolean):void
executeInBackground | eigenschap |
executeInBackground:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3.3 |
Geeft aan of de toepassing al dan niet op de achtergrond wordt uitgevoerd.
Als de waarde van executeInBackground
gelijk is aan false
(de standaardwaarde), wordt de toepassing 'stilgezet' wanneer deze naar de achtergrond wordt gestuurd. Wanneer de waarde van executeInBackground
gelijk is aan true
, kan de toepassing op de achtergrond worden uitgevoerd.
Opmerking: in SWF-versie 21 en eerder biedt AIR op iOS en Android geen ondersteuning voor achtergronduitvoering als de rendermodus Direct is ingesteld. Daarom kunnen op Stage3D gebaseerde apps geen achtergrondtaken uitvoeren, zoals het afspelen van audio, het bijwerken van de locatie, het uploaden en downloaden naar en van het netwerk, enz. Op iOS is het uitvoeren van OpenGLES-/renderingaanroepen op de achtergrond niet toegestaan. Toepassingen die proberen OpenGL-aanroepen uit te voeren op de achtergrond worden door iOS beëindigd. Android beperkt toepassingen niet in het uitvoeren van OpenGLES-aanroepen op de achtergrond of in het uitvoeren van andere achtergrondtaken, zoals het afspelen van audio. In SWF-versie 22 en hoger kunnen mobiele AIR-toepassingen op de achtergrond worden uitgevoerd wanneer de renderMode Direct is ingesteld. De AIR iOS-runtime resulteert in een ActionScript-fout (3768 - De Stage3D API kan niet worden gebruikt tijdens uitvoering op de achtergrond) als OpenGLES-aanroepen worden uitgevoerd op de achtergrond. Op Android is echter geen sprake van fouten, omdat native toepassingen OpenGLES-aanvragen kunnen uitvoeren op de achtergrond. Voor optimaal gebruik van mobiele resources kunt u beter geen renderingaanroepen uitvoeren als een toepassing op de achtergrond wordt uitgevoerd.
Deze eigenschap wordt ondersteund op AIR iOS en Android.
Implementatie
public function get executeInBackground():Boolean
public function set executeInBackground(value:Boolean):void
icon | eigenschap |
icon:InteractiveIcon
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Het toepassingspictogram.
Gebruik NativeApplication.supportsDockIcon
en NativeApplication.supportsSystemTrayIcon
om de pictogramklasse te bepalen. Het type wordt een van de subklassen van InteractiveIcon. In Mac® OS X is NativeApplication.icon
een object van het type DockIcon
. In Windows ® is NativeApplication.icon
een object van het type SystemTrayIcon
. Wanneer een toepassingspictogram niet wordt ondersteund, zijn NativeApplication.supportsDockIcon
en NativeApplication.supportsSystemTrayIcon
allebei false
en is de waarde van de eigenschap icon
gelijk aan null
.
Het object icon
wordt automatisch gecreëerd, maar wordt niet met afbeeldingsgegevens geïnitialiseerd. In sommige besturingssystemen, zoals Mac OS X, is een standaardafbeelding beschikbaar. Op andere, zoals Windows, wordt alleen een pictogram weergegeven als er afbeeldingsgegevens aan zijn toegewezen. Stel de eigenschap icon.bitmaps
in met een array die minstens een object BitmapData bevat als u een pictogramafbeelding wilt toewijzen. Als er meer dan een BitmapData-object in de array is opgenomen, kiest het besturingssysteem de afbeelding die het weergaveformaat van het pictogram het dichtst benadert en wordt de afbeelding indien nodig geschaald.
Implementatie
public function get icon():InteractiveIcon
Verwante API-elementen
idleThreshold | eigenschap |
idleThreshold:int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Het aantal seconden zonder gebruikersinvoer dat is verstreken voordat een userIdle-gebeurtenis wordt verzonden.
De standaardwaarde voor niet-actieve tijd van is 300 seconden (5 minuten). Het aanvaardbare bereik van waarden loopt van 5 (5 seconden) tot en met 86.400 (1 dag).
Implementatie
public function get idleThreshold():int
public function set idleThreshold(value:int):void
Gegenereerde uitzondering
ArgumentError — Als u probeert om de eigenschap op een ongeldige waarde in te stellen. Het aanvaardbare bereik van waarden loopt van 5 (5 seconden) tot en met 86.400 (1 dag).
|
Verwante API-elementen
isCompiledAOT | eigenschap |
isCompiledAOT:Boolean
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 25.0 |
Geeft aan of de toepassing wordt gecompileerd of voor het gewenste platform wordt geïnterpreteerd. Deze API retourneert alleen (true
) voor iOS voor doelen (de ipa-app-store, ipa-test, ipa-debug, ipa-ad-hoc). Voor andere AIR-platforms retourneert deze API (false
).
Implementatie
public function get isCompiledAOT():Boolean
menu | eigenschap |
menu:NativeMenu
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Het toepassingsmenu.
Toepassingsmenu's worden ondersteund als de waarde van NativeApplication.supportsMenu
true
is. Toepassingsmenu's worden niet door alle besturingssystemen ondersteund. Toepassingsmenu's worden bijvoorbeeld ondersteund door Mac OS X, maar niet door Windows of Linux. Het toewijzen van een object NativeMenu aan deze eigenschap wanneer de waarde van NativeApplication.supportsMenu
false
is, is toegestaan maar heeft geen effect. Gebruik de eigenschap NativeApplication.supportsMenu
om te bepalen of het besturingssysteem toepassingsmenu's ondersteunt. Bepaal met behulp van andere middelen (zoals Capabilities.os
) of ondersteuning kan leiden tot programmeringsfouten (als er geen rekening wordt gehouden met bepaalde doelbesturingssystemen).
AIR-profielondersteuning: deze functie wordt niet ondersteund op mobiele apparaten en ook niet op AIR for TV-apparaten. Zie AIR-profielondersteuning voor meer informatie over API-ondersteuning voor meerdere profielen.
Opmerking: In Mac OS X verwijst de eigenschap menu
naar het standaardtoepassingsmenu dat door het besturingssysteem wordt aangeleverd. U kunt de bestaande menustructuur aanpassen door items en submenu's toe te voegen en te verwijderen, en door gebeurtenislisteners toe te voegen. U kunt de standaardmenu's ook geheel vervangen door een nieuw NativeMenu-object aan deze eigenschap menu
toe te kennen.
Implementatie
public function get menu():NativeMenu
public function set menu(value:NativeMenu):void
Verwante API-elementen
nativeApplication | eigenschap |
nativeApplication:NativeApplication
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
De singleton instantie van het NativeApplication-object.
Implementatie
public static function get nativeApplication():NativeApplication
Gegenereerde uitzondering
Error — Als dit wordt benaderd door inhoud buiten de beveiligingssandbox van de toepassing.
|
openedWindows | eigenschap |
openedWindows:Array
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Een array die alle geopende eigen vensters van deze toepassing bevat.
Deze eigenschap wordt niet ondersteund op platforms die geen ondersteuning bieden voor de NativeWindow-klasse.
Implementatie
public function get openedWindows():Array
publisherID | eigenschap |
publisherID:String
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
De uitgevers-id van deze toepassing.
De waarde van deze id wordt ingesteld in het bestand publisherid van de toepassing. Dit bestand wordt tijdens de installatie gegenereerd vanuit de certificaatketen die wordt gebruikt om de toepassing te ondertekenen.
Implementatie
public function get publisherID():String
runtimePatchLevel | eigenschap |
runtimeVersion | eigenschap |
startAtLogin | eigenschap |
startAtLogin:Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Geeft aan of de toepassing automatisch wordt gestart wanneer de huidige gebruiker zich aanmeldt.
AIR-profielondersteuning: deze functie wordt ondersteund op alle desktopbesturingssystemen, maar niet op mobiele apparaten en ook niet op AIR for TV-apparaten. Met de eigenschap NativeApplication.supportsStartAtLogin
kunt u testen op ondersteuning tijdens runtime. Zie AIR-profielondersteuning voor meer informatie over API-ondersteuning voor meerdere profielen.
De eigenschap startAtLogin
geeft de status weer van het mechanisme (gedefinieerd door het besturingssysteem) voor het bepalen of een toepassing automatisch moet worden gestart als een gebruiker zich aanmeldt. De gebruiker kan de status handmatig wijzigen via de gebruikersinterface van het besturingssysteem. Deze eigenschap geeft de huidige status weer, en geeft weer of de status het laatst door de AIR-toepassing of door het besturingssysteem werd gewijzigd.
Implementatie
public function get startAtLogin():Boolean
public function set startAtLogin(value:Boolean):void
Gegenereerde uitzondering
IllegalOperationError — Als in Windows een andere toepassing met dezelfde naam (maar met een verschillend pad naar het uitvoerbare bestand) reeds is ingesteld om te worden gestart als deze gebruiker zich aanmeldt.
| |
IllegalOperationError — Als deze toepassing niet is geïnstalleerd, wat het geval kan zijn als deze door de AIR Debug Launcher (ADL) wordt gestart.
|
Verwante API-elementen
supportsDefaultApplication | eigenschap |
supportsDefaultApplication:Boolean
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 2 |
Geeft aan of setAsDefaultApplication()
, removeAsDefaultApplication()
en isSetAsDefaultApplication()
worden ondersteund op het huidige platform.
Als de waarde true
is, werken de bovenstaande methoden zoals beschreven. Als de waarde false
is, werken setAsDefaultApplication()
en removeDefaultApplication()
niet en retourneert isSetAsDefaultApplication()
de waarde false
.
Implementatie
public static function get supportsDefaultApplication():Boolean
Verwante API-elementen
supportsDockIcon | eigenschap |
supportsDockIcon:Boolean
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Geeft aan of op het huidige besturingssysteem Dock-pictogrammen voor toepassingen door AIR worden ondersteund.
Bij de waarde true
is de eigenschap NativeApplication.icon
van het type DockIcon
.
De MAC OS X-gebruikersinterface biedt een toepassing 'koppeling' die pictogrammen bevat voor toepassingen die actief zijn of die regelmatig worden gebruikt.
Gebruik de eigenschap NativeApplication.supportsDockIcon
om te bepalen of het besturingssysteem toepassingsmenu's ondersteunt. Bepaal met behulp van andere middelen (zoals Capabilities.os
) of ondersteuning kan leiden tot programmeringsfouten (als er geen rekening wordt gehouden met bepaalde doelbesturingssystemen).
Implementatie
public static function get supportsDockIcon():Boolean
Verwante API-elementen
supportsMenu | eigenschap |
supportsMenu:Boolean
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Geeft aan of een algemene toepassingsmenubalk door het huidige besturingssysteem wordt ondersteund.
Als de waarde true
is, kan de eigenschap NativeApplication.menu
worden gebruikt om een native toepassingsmenu te definiëren (of te openen).
Gebruik de eigenschap NativeApplication.supportsMenu
om te bepalen of het besturingssysteem toepassingsmenu's ondersteunt. Bepaal met behulp van andere middelen (zoals Capabilities.os
) of ondersteuning kan leiden tot programmeringsfouten (als er geen rekening wordt gehouden met bepaalde doelbesturingssystemen).
Implementatie
public static function get supportsMenu():Boolean
Verwante API-elementen
supportsStartAtLogin | eigenschap |
supportsStartAtLogin:Boolean
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 2 |
Geeft aan of startAtLogin op het huidige platform wordt ondersteund.
Als deze true
is, werkt startAtLogin zoals beschreven. Als deze false
is, heeft startAtLogin geen effect.
Implementatie
public static function get supportsStartAtLogin():Boolean
Verwante API-elementen
supportsSystemTrayIcon | eigenschap |
supportsSystemTrayIcon:Boolean
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Geeft aan of op het huidige besturingssysteem systeemvakpictogrammen voor toepassingen door AIR worden ondersteund.
Bij de waarde true
is de eigenschap NativeApplication.icon
van het type SystemTrayIcon
.
De Windows gebruikersinterface heeft het 'systeemtray'-gebied van de taakbalk, die officieel het Meldingsgedeelte heet en waarin de toepassingspictogrammen worden weergegeven. Er wordt geen standaardpictogram weergegeven. U moet de array bitmaps
van het pictogramobject instellen, zodat er een pictogram wordt weergegeven.
Gebruik de eigenschap NativeApplication.supportsSystemTrayIcon
om te bepalen of het besturingssysteem systeemtraypictogrammen ondersteunt. Bepaal met behulp van andere middelen (zoals Capabilities.os
) of ondersteuning kan leiden tot programmeringsfouten (als er geen rekening wordt gehouden met bepaalde doelbesturingssystemen).
Implementatie
public static function get supportsSystemTrayIcon():Boolean
Verwante API-elementen
systemIdleMode | eigenschap |
systemIdleMode:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 2 |
Biedt een manier waarop toepassingen kunnen voorkomen dat de gebruikersinterface overschakelt naar de modus Niet-actief.
Een waarde van de SystemIdleMode-klasse die het gedrag van de modus Niet-actief van het hostsysteem beïnvloedt. Deze eigenschap werkt alleen voor de toepassing met invoerfocus en kan alleen worden geopend vanaf content die in de toepassingssandbox actief is.
AIR-profielondersteuning: deze functie wordt ondersteund op mobiele apparaten, maar niet op desktopbesturingssystemen en ook niet op AIR for TV-apparaten. Zie AIR-profielondersteuning voor meer informatie over API-ondersteuning voor meerdere profielen.
Implementatie
public function get systemIdleMode():String
public function set systemIdleMode(value:String):void
Verwante API-elementen
timeSinceLastUserInput | eigenschap |
activate | () | methode |
public function activate(window:NativeWindow = null):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Activeert deze toepassing.
Deze methode wordt niet ondersteund op platforms die geen ondersteuning bieden voor de NativeWindow-klasse.
Onder bepaalde voorwaarden die door het besturingssysteem worden vastgelegd, zal deze methode een toepassing niet activeren. In de meeste besturingssystemen wordt de mogelijkheid dat een toepassing zichzelf activeert beperkt om te verhinderen dat de toepassing per ongeluk of met slechte bedoelingen een gebruiker de toegang tot andere toepassingen onmogelijk maakt.
Als het besturingssysteem activering toestaat, wordt het opgegeven venster geactiveerd en op de voorgrond van het bureaublad geplaatst, dus vóór de vensters van andere toepassingen. (Als de parameter window
null
is, wordt een zichtbaar venster van deze toepassing geactiveerd.)
De methode activate()
heeft geen effect als de toepassing geen zichtbare vensters heeft.
De activeringsbewerking is synchroon.
Parameters
window:NativeWindow (default = null ) — Het NativeWindow-object van het venster dat samen met de toepassing moet worden geactiveerd.
|
Gebeurtenissen
activate: — Wordt verzonden als de activeringsstatus verandert.
|
addEventListener | () | methode |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Runtimeversies: | AIR 1.0 |
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. U kunt gebeurtenislisteners registreren op alle knooppunten in het weergaveoverzicht van een specifiek type gebeurtenis, fase of prioriteit.
Nadat het registreren van een gebeurtenislistener is voltooid, kunt u de prioriteit ervan niet wijzigen door extra aanroepen van addEventListener()
. Wanneer u de prioriteit van een listener wilt wijzigen, moet u eerst removeListener()
aanroepen. U kunt de listener opnieuw registreren met het nieuwe prioriteitsniveau.
Nadat de listener is geregistreerd, resulteren volgende aanroepen van addEventListener()
met een andere waarde voor type
of useCapture
in het maken van een afzonderlijke listenerregistratie. Wanneer u bijvoorbeeld eerst een listener registreert bij useCapture
ingesteld op true
, luistert deze alleen tijdens de vastlegfase. Wanneer u addEventListener()
opnieuw aanroept met hetzelfde listenerobject maar met useCapture
ingesteld op false
, hebt u twee afzonderlijke listeners: één die tijdens de vastlegfase luistert en één die tijdens de doel- en terugkoppelfasen luistert.
U kunt geen gebeurtenislistener registeren voor alleen de doel- of terugkoppelfase. Deze fasen worden bij de registratie gekoppeld, omdat terugkoppeling alleen van toepassing is op voorouders van het doelknooppunt.
Wanneer u een gebeurtenislistener niet langer nodig hebt, kunt u deze verwijderen door removeEventListener()
aan te roepen; anders kan dit resulteren in geheugenproblemen. Gebeurtenisluisteraars worden niet automatisch uit het geheugen verwijderd, omdat de verzamelaar met ongewenste details de luisteraar niet verwijderd zolang het verzendende object bestaat (behalve als de parameter useWeakReference
op true
is ingesteld).
Het kopiëren van een instantie EventDispatcher kopieert de daaraan gekoppelde gebeurtenislisteners. (Wanneer uw nieuwe knooppunt een gebeurtenislistener nodig heeft, moet u de listener eraan koppelen na het maken van het knooppunt.) Wanneer u echter een instantie EventDispatcher verplaatst, worden de daaraan gekoppelde listeners mee verplaatst.
Wanneer de gebeurtenislistener wordt geregistreerd op een knooppunt terwijl een gebeurtenis op dit knooppunt wordt verwerkt, wordt de gebeurtenislistener niet geactiveerd tijdens de huidige fase maar kan wel worden geactiveerd in een latere fase in de gebeurtenisstroom, zoals de terugkoppelfase.
Wanneer een gebeurtenislistener wordt verwijderd uit een knooppunt terwijl een gebeurtenis wordt verwerkt op het knooppunt, wordt deze nog steeds geactiveerd door de huidige handelingen. Nadat deze is verwijderd, wordt de gebeurtenislistener niet meer aangeroepen (tenzij deze opnieuw wordt geregistreerd voor toekomstige verwerking).
Parameters
type:String — Het type gebeurtenis.
| |
listener:Function — De listenerfunctie die de gebeurtenis verwerkt. Deze functie moet een Event-object accepteren als de enige parameter en niets retourneren, zoals in dit voorbeeld wordt getoond:
function(evt:Event):void De functie kan elke naam hebben. | |
useCapture:Boolean (default = false ) —
Bepaalt of de listener werkt in de vastleg-, doel- en terugkoppelfase. Wanneer useCapture wordt ingesteld op true , verwerkt de listener de gebeurtenis alleen tijdens de vastlegfase en niet tijdens de doel- of terugkoppelfase. Wanneer useCapture wordt ingesteld op false , verwerkt de listener de gebeurtenis alleen tijdens de doel- of terugkoppelfase. Wanneer u in alle drie de fasen naar de gebeurtenis wilt luisteren, roept u addEvenListener() tweemaal aan, één keer met useCapture ingesteld op true en één keer met useCapture ingesteld op false .
| |
priority:int (default = 0 ) — Het prioriteitsniveau van de gebeurtenislistener. De prioriteit is opgegeven door een 32-bits geheel getal. Hoe hoger het getal, hoe hoger de prioriteit. Alle listeners met een prioriteit n worden verwerkt voor listeners met een prioriteit n -1. Wanneer twee of meer listeners dezelfde prioriteit hebben, worden ze verwerkt in de volgorde waarin ze werden toegevoegd. De standaardprioriteit is 0.
| |
useWeakReference:Boolean (default = false ) — Bepaalt of de verwijzing van de listener sterk of zwak is. Een sterke verwijzing (standaard) voorkomt dat uw listener wordt opgeschoond. Een zwakke verwijzing doet dat niet. Lidfuncties op klasseniveau worden niet opgeschoond. U kunt dus |
clear | () | methode |
public function clear():Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Roept een interne verwijderopdracht op het gefocuste weergaveobject aan.
Deze functieaanroep wordt genegeerd als het object dat de focus heeft, de opdracht niet implementeert. Momenteel implementeren alleen weergaveobjecten die afkomstig zijn van de klassen TextField of HTMLLoader deze opdracht.
Opmerking: Met de opdracht clear()
verwijdert u geselecteerde tekst. Als er niets is geselecteerd, wordt niet alle tekst gewist.
Boolean — true .
|
copy | () | methode |
public function copy():Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Roept een interne kopieeropdracht op het gefocuste weergaveobject aan.
Deze functieaanroep wordt genegeerd als de component de opdracht niet implementeert. Momenteel implementeren alleen weergaveobjecten die afkomstig zijn van de klassen TextField of HTMLLoader deze opdracht.
Geretourneerde waardeBoolean |
cut | () | methode |
public function cut():Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Roept een interne knipopdracht op het gefocuste weergaveobject aan.
Deze functieaanroep wordt genegeerd als de component de opdracht niet implementeert. Momenteel implementeren alleen weergaveobjecten die afkomstig zijn van de klassen TextField of HTMLLoader deze opdrachten.
Geretourneerde waardeBoolean — true .
|
dispatchEvent | () | methode |
override public function dispatchEvent(event:Event):Boolean
Runtimeversies: | AIR 1.0 |
Verzendt een gebeurtenis naar de gebeurtenisstroom. Het doel van de gebeurtenis is het object EventDispatcher waar de methode dispatchEvent()
op wordt aangeroepen.
Parameters
event:Event — Het Event-object dat naar de gebeurtenisstroom is verzonden. Wanneer de gebeurtenis opnieuw wordt verzonden, wordt automatisch een kloon van de gebeurtenis gemaakt. Nadat een gebeurtenis is verzonden, kan de eigenschap target ervan niet meer worden gewijzigd. U moet daarom een nieuwe kopie van de gebeurtenis maken om opnieuw verzenden mogelijk te maken.
|
Boolean — De waarde true wanneer het verzenden van de gebeurtenis is voltooid. Een waarde false geeft aan dat verzending is mislukt of dat preventDefault() op de gebeurtenis is aangeroepen.
|
exit | () | methode |
public function exit(errorCode:int = 0):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Sluit de toepassing af.
Het aanroepen van de methode exit()
keert terug. De afsluitprocedure begint niet voordat de code die momenteel wordt uitgevoerd (zoals een huidige gebeurtenishandler) is voltooid. Asynchrone bewerkingen die in behandeling zijn, worden geannuleerd en worden mogelijk niet meer voltooid.
Opmerking: er wordt geen exiting
-gebeurtenis verzonden. Roep NativeApplication.nativeApplication.dispatchEvent()
aan als de toepassingslogica een gebeurtenis exiting
vereist. Hierdoor wordt een Event-object van het type exiting
doorgegeven. Voor alle open vensters, versturen NativeWindows-objecten closing
- en close
-gebeurtenissen Wanneer u de preventDefault()
-methode van een closing
-gebeurtenisobject oproept, voorkomt u dat de toepassing wordt afgesloten.
Opmerking: deze methode wordt niet ondersteund op het iOS-besturingssysteem.
Parameters
errorCode:int (default = 0 ) — De afsluitcode die bij het afsluiten van de toepassing aan het besturingssysteem wordt gerapporteerd.
|
getDefaultApplication | () | methode |
public function getDefaultApplication(extension:String):String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Hiermee wordt de standaardtoepassing voor het openen van bestanden met de opgegeven extensie opgehaald.
Opmerking: Deze methode kan alleen worden gebruikt voor bestandstypen die zijn toegewezen in de instructie fileTypes
van het toepassingsbeschrijvingsbestand.
Deze methode is niet van toepassing op AIR for TV-apparaten. Als u de methode aanroept met een bestandstype dat is opgegeven in het beschrijvingsbestand van de toepassing, wordt de waarde null
geretourneerd.
Parameters
extension:String — Een String die de extensie van het betreffende bestandstype bevat (zonder ".").
|
String — Het pad van de standaardtoepassing.
|
Gegenereerde uitzondering
Error — Als de parameter extension niet een van de bestandsextensies bevat die in het toepassingsbeschrijvingsbestand zijn gedeclareerd.
|
Verwante API-elementen
isSetAsDefaultApplication | () | methode |
public function isSetAsDefaultApplication(extension:String):Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Geeft aan of deze toepassing momenteel de standaardtoepassing is voor het openen van bestanden met de opgegeven extensie.
AIR-profielondersteuning: deze functie wordt ondersteund op alle desktopbesturingssystemen, maar niet op mobiele apparaten en ook niet op AIR for TV-apparaten. Met de eigenschap NativeApplication.supportsDefaultApplication
kunt u testen op ondersteuning tijdens runtime. Zie AIR-profielondersteuning voor meer informatie over API-ondersteuning voor meerdere profielen.
Parameters
extension:String — Een String die de extensie van het betreffende bestandstype bevat (zonder ".").
|
Boolean — true als deze toepassing de standaardtoepassing is.
|
Gegenereerde uitzondering
Error — Als de parameter extension niet een van de bestandsextensies bevat die in het toepassingsbeschrijvingsbestand zijn gedeclareerd.
|
Verwante API-elementen
paste | () | methode |
public function paste():Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Roept een interne plakopdracht op het gefocuste weergaveobject aan.
Deze functieaanroep wordt genegeerd als de component de opdracht niet implementeert. Momenteel implementeren alleen weergaveobjecten die afkomstig zijn van de klassen TextField of HTMLLoader deze opdracht.
Geretourneerde waardeBoolean — true .
|
removeAsDefaultApplication | () | methode |
public function removeAsDefaultApplication(extension:String):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Verwijdert deze toepassing als de standaardtoepassing voor het openen van bestanden met de opgegeven extensie.
Opmerking: Deze methode kan alleen worden gebruikt voor bestandstypen die zijn opgegeven in de instructie fileTypes
in het toepassingsbeschrijvingsbestand.
Parameters
extension:String — Een String die de extensie van het betreffende bestandstype bevat (zonder ".").
|
Gegenereerde uitzondering
Error — Als de parameter extension niet een van de bestandsextensies bevat die in het toepassingsbeschrijvingsbestand zijn gedeclareerd.
|
Verwante API-elementen
removeEventListener | () | methode |
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Runtimeversies: | AIR 1.0 |
Verwijdert een listener uit het object EventDispatcher. Wanneer geen overeenkomende listener is geregistreerd bij het object EventDispatcher, heeft een aanroep van deze methode geen invloed.
Parameters
type:String — Het type gebeurtenis.
| |
listener:Function — Het listenerobject dat wordt verwijderd.
| |
useCapture:Boolean (default = false ) —
Geeft aan of de listener is geregistreerd voor de vastleg-, doel- en terugkoppelfase. Wanneer de listener is geregistreerd voor zowel de vastlegfase als de doel- en terugkoppelfase, zijn twee aanroepen van de removeEventListener() nodig om beide te verwijderen, één met useCapture ingesteld op true en één met useCapture ingesteld op false .
|
selectAll | () | methode |
public function selectAll():Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Roept een interne opdracht selectAll op het gefocuste weergaveobject aan.
Deze functieaanroep wordt genegeerd als de component de opdracht niet implementeert. Momenteel implementeren alleen weergaveobjecten die afkomstig zijn van de klassen TextField of HTMLLoader deze opdracht.
Geretourneerde waardeBoolean — true .
|
setAsDefaultApplication | () | methode |
public function setAsDefaultApplication(extension:String):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Stelt deze toepassing in als de standaardtoepassing voor het openen van bestanden met de opgegeven extensie.
Opmerking: Deze methode kan alleen worden gebruikt voor bestandstypen die zijn toegewezen in de instructie fileTypes
in het toepassingsbeschrijvingsbestand.
Parameters
extension:String — Een String die de extensie van het betreffende bestandstype bevat (zonder ".").
|
Gegenereerde uitzondering
Error — Als de parameter extension niet een van de bestandsextensies bevat die in het toepassingsbeschrijvingsbestand zijn gedeclareerd.
|
Verwante API-elementen
activate | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.ACTIVATE
Runtimeversies: | AIR 1.0 |
Wordt verzonden als deze toepassing de actieve toepassing op het bureaublad wordt.
De constanteACTIVATE
bevat de waarde van de eigenschap type
van een activate
-gebeurtenisobject.
Opmerking: Deze gebeurtenis heeft geen 'vastlegfase' en geen 'bubbelfase', wat betekent dat gebeurtenislisteners rechtstreeks aan mogelijke doelen moeten worden toegevoegd, ongeacht of het doel voorkomt in de weergavelijst.
Deze gebeurtenis wordt nooit automatisch verzonden door AIR for TV. U kunt de gebeurtenis wel handmatig verzenden.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Elke DisplayObject-instantie met een listener die is geregistreerd voor de activate -gebeurtenis. |
browserInvoke | Gebeurtenis |
flash.events.BrowserInvokeEvent
eigenschap BrowserInvokeEvent.type =
flash.events.BrowserInvokeEvent.Browser_INVOKE
Runtimeversies: | AIR 1.0 |
Wordt verzonden wanneer een toepassing wordt geactiveerd door een SWF-bestand dat in de browser van de gebruiker wordt uitgevoerd.
Browseractivering is alleen toegestaan als een toepassing het volgende opgeeft in het descriptorbestand van de toepassing:
<allowBrowserInvocation>true</allowBrowserInvocation>
deactivate | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.DEACTIVATE
Runtimeversies: | AIR 1.0 |
Wordt verzonden wanneer de focus van het bureaublad naar een andere toepassing wordt omgeschakeld.
De constanteEvent.DEACTIVATE
definieert de waarde van de eigenschap type
van een deactivate
-gebeurtenisobject.
Opmerking: Deze gebeurtenis heeft geen 'vastlegfase' en geen 'bubbelfase', wat betekent dat gebeurtenislisteners rechtstreeks aan mogelijke doelen moeten worden toegevoegd, ongeacht of het doel voorkomt in de weergavelijst.
Deze gebeurtenis wordt nooit automatisch verzonden door AIR for TV. U kunt de gebeurtenis wel handmatig verzenden.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Elke DisplayObject-instantie met een listener die is geregistreerd voor de deactivate -gebeurtenis. |
exiting | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.EXITING
Runtimeversies: | AIR 1.0 |
Wordt verzonden als de afsluitprocedure van de toepassing wordt gestart.
De exiting
-gebeurtenis wordt verzonden wanneer de afsluitprocedure van de toepassing wordt geïnitieerd door het besturingssysteem, bijvoorbeeld wanneer een gebruiker op een Mac OS X de toetsencombinatie Cmd-Q
gebruikt of wanneer de eigenschap autoExit
van het NativeApplication-object true
is en het laatste toepassingsvenster wordt gesloten. Door deze gebeurtenis te annuleren wordt verhinderd dat de toepassing wordt afgesloten.
Bij AIR for TV-apparaten wordt de exiting
-gebeurtenis nooit verzonden.
Opmerking: wanneer de methode exit()
van NativeApplication wordt aangeroepen, wordt geen exiting
-gebeurtenis verzonden. Als u onderdelen wilt waarschuwen voor een op handen zijnde afsluitprocedure, verzendt u de exiting
-gebeurtenis alvorens exit()
aan te roepen.
Event.EXITING
definieert de waarde van de eigenschap type
van een exiting
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | true ; door dit gebeurtenisobject te annuleren, wordt het afsluiten gestopt. |
currentTarget | Het NativeApplication-object. |
target | Het NativeApplication-object. |
invoke | Gebeurtenis |
flash.events.InvokeEvent
eigenschap InvokeEvent.type =
flash.events.InvokeEvent.INVOKE
Runtimeversies: | AIR 1.0 |
Wordt verzonden wanneer de toepassing wordt aangeroepen.
Er wordt geen tweede instantie van de toepassing gestart als een toepassing voor de tweede maal wordt aangeroepen. In plaats daarvan ontvangt de eerste instantie een bijkomende aanroepgebeurtenis. De toepassing is er voor verantwoordelijk dat de volgende gebeurtenissen invoke
naar behoren worden afgehandeld.
Opmerking: alle gebeurtenissen invoke
worden in een wachtrij geplaatst. Als er voor deze gebeurtenis een listener is geregistreerd, zal deze alle gebeurtenissen in de wachtrij en eventueel nieuwe gebeurtenissen ontvangen. Gebeurtenissen in de wachtrij kunnen worden aangeleverd voor of na eventueel nieuwe gebeurtenissen invoke
.
InvokeEvent.INVOKE
definieert de waarde van de eigenschap type
van een InvokeEvent-object.
Het InvokeEvent-object heeft de volgende eigenschappen:
Eigenschappen | Waarden |
---|---|
arguments | De array met tekenreeksargumenten die tijdens de activering wordt doorgegeven. |
currentDirectory | File-object dat de map voorstelt die moet worden gebruikt voor het oplossen van relatieve paden in de array met argumenten. |
reason | een code die aangeeft of de aanroepgebeurtenis werd verzonden omdat de toepassing automatisch is gestart bij aanmelding (InvokeEventReason.LOGIN ), werd gestart als antwoord op een extern bericht (InvokeEventReason.NOTIFICATION , alleen iOS), omdat de toepassing werd aangeroepen door een andere toepassing (InvokeEventReason.OPEN_URL ) of om een andere reden (InvokeEventReason.STANDARD ). Beschikbaar vanaf AIR-versie 1.5.1. |
bubbles | false . |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Geeft het object aan dat dit InvokeEvent-object actief verwerkt met een gebeurtenislistener. |
target | Altijd het NativeApplication-object. |
keyDown | Gebeurtenis |
flash.events.KeyboardEvent
eigenschap KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Wordt verzonden wanneer de gebruiker op een toets drukt. De instantie NativeApplication biedt deze gebeurtenis ter ondersteuning van sneltoetsen op het toetsenbord. Deze toetsenbordgebeurtenis wordt eerst naar NativeApplication verzonden. Als deze gebeurtenis wordt geannuleerd, worden ook de sneltoetsen in het NativeWindow-menu geannuleerd. Deze gebeurtenis treedt op vóór de gebeurtenis keyUp
.
KeyboardEvent.KEY_DOWN
definieert de waarde van de eigenschap type
van een keyDown
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | true in AIR, false in Flash Player. Als deze gebeurtenis in AIR wordt geannuleerd, wordt het teken niet ingevoegd in een tekstveld. |
charCode | De waarde van de tekencode van de toets die is ingedrukt of losgelaten. |
commandKey | true op de Mac als de Command-toets actief is. Anders is deze false |
controlKey | true onder Windows enLinux als de Ctrl-toets actief is. true op de Mac als de Control-toets actief is. Anders is deze false |
ctrlKey | true onder Windows enLinux als de Ctrl-toets actief is. true op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze false . |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
keyCode | De waarde van de toetscode van de toets die is ingedrukt of losgelaten. |
keyLocation | De locatie van de toets op het toetsenbord. |
shiftKey | true wanneer de Shift-toets actief is of false wanneer deze inactief is. |
target | De instantie InteractiveObject met focus. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
Verwante API-elementen
keyUp | Gebeurtenis |
flash.events.KeyboardEvent
eigenschap KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0 |
Wordt verzonden wanneer de gebruiker een toets loslaat. De instantie NativeApplication biedt deze gebeurtenis ter ondersteuning van sneltoetsen op het toetsenbord. Deze toetsenbordgebeurtenis wordt eerst naar NativeApplication verzonden. Als deze gebeurtenis wordt geannuleerd, heeft dat geen gevolgen voor andere objecten (zoals sneltoetsen in het NativeWindow-menu). Deze gebeurtenis treedt op vóór de gebeurtenis keyDown
.
KeyboardEvent.KEY_UP
definieert de waarde van de eigenschap type
van een keyUp
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | true |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
charCode | Deze bevat de waarde van de tekenreekscode van de laatste toets die is ingedrukt of losgelaten. |
commandKey | true op de Mac als de Command-toets actief is. Anders is deze false |
controlKey | true onder Windows enLinux als de Ctrl-toets actief is. true op de Mac als de Control-toets actief is. Anders is deze false |
ctrlKey | true onder Windows als de Ctrl-toets actief is. true op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze false . |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
keyCode | De waarde van de toetscode van de toets die is ingedrukt of losgelaten. |
keyLocation | De locatie van de toets op het toetsenbord. |
shiftKey | true wanneer de Shift-toets actief is of false wanneer deze inactief is. |
target | De instantie InteractiveObject met focus. Het target is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap currentTarget voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt. |
Verwante API-elementen
networkChange | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.NETWORK_CHANGE
Runtimeversies: | AIR 1.0 |
Wordt verzonden als er een nieuwe netwerkverbinding beschikbaar wordt of als er een bestaande netwerkverbinding verloren gaat.
Een gebeurtenis networkChange
betekent niet noodzakelijk dat de hostcomputer online of offline is gegaan. Het is ook mogelijk dat de hostcomputer van het ene naar het andere verbindingstype overschakelt. Toepassingen kunnen deze gebeurtenis gebruiken om de beschikbaarheid van bronnen op afstand beter te kunnen controleren. Het verzenden van een gebeurtenis networkChange
is doorgaans een goed moment om te controleren of er bronnen op afstand beschikbaar zijn.
Opmerkingen:
- Er kan een korte vertraging optreden tussen een netwerkverandering en de levering van deze gebeurtenis.
- Bij Android kan het NativeApplication-object meerdere networkChange-gebeurtenissen verzenden voor elke verandering in een netwerkverbinding.
Event.NETWORK_CHANGE
definieert de waarde van de eigenschap type
van een networkChange
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het NativeApplication-object. |
suspend | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.SUSPEND
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 3.3 |
Verzonden wanneer de toepassing wordt onderbroken door het besturingssysteem.
De constanteEvent.SUSPEND
definieert de waarde van de type
-eigenschap van een suspend
-gebeurtenisobject. Deze gebeurtenis wordt alleen verzonden op AIR iOS.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het NativeApplication-object. |
target | Het NativeApplication-object. |
userIdle | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.USER_IDLE
Runtimeversies: | AIR 1.0 |
Wordt verzonden als de gebruiker inactief is geweest.
Geef met de eigenschap idleThreshold
op hoe lang de gebruiker inactief moet zijn voordat deze gebeurtenis wordt verzonden. De tijd waarin de gebruiker inactief is kan worden bepaald via de eigenschap timeSinceLastUserInput
.
Opmerking: deze gebeurtenis wordt niet verzonden op mobiele apparaten en ook niet op AIR for TV-apparaten.
De constanteEvent.USER_IDLE
definieert de waarde van de eigenschap type
van een userIdle
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
target | Het NativeApplication-object. |
Verwante API-elementen
userPresent | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.USER_PRESENT
Runtimeversies: | AIR 1.0 |
Wordt verzonden wanneer het besturingssysteem na een periode zonder activiteit muis- of toetsenbordactiviteiten detecteert.
Opmerking: deze gebeurtenis wordt niet verzonden op mobiele apparaten en ook niet op AIR for TV-apparaten.
De inactieve periode kan worden ingesteld met de eigenschap idleThreshold
. De tijd waarin de gebruiker inactief is kan worden bepaald via de eigenschap timeSinceLastUserInput
.
Event.USER_PRESENT
definieert de waarde van de eigenschap type
van een userPresent
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
target | Het NativeApplication-object. |
Verwante API-elementen
Wed Jun 13 2018, 11:42 AM Z