| Paket | flash.desktop |
| Klasse | public final class NativeApplication |
| Vererbung | NativeApplication  EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Die NativeApplication-Klasse bietet Informationen zur Anwendung sowie anwendungsumfassende Funktionen und löst Ereignisse auf Anwendungsebene aus.
Das NativeApplication-Objekt ist ein Singleton-Objekt, das beim Programmstart automatisch erstellt wird. Sie rufen die NativeApplication-Instanz einer Anwendung mit der statischen Eigenschaft NativeApplication.nativeApplication ab.
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| activeWindow : NativeWindow [schreibgeschützt]
Das aktive Fenster der Anwendung. | NativeApplication | ||
| applicationDescriptor : XML [schreibgeschützt]
Der Inhalt der Anwendungsdeskriptordatei für diese AIR-Anwendung. | NativeApplication | ||
| applicationID : String [schreibgeschützt]
Die Anwendungs-ID dieser Anwendung. | NativeApplication | ||
| autoExit : Boolean
Legt fest, ob die Anwendung automatisch beendet wird, wenn alle Fenster geschlossen wurden. | NativeApplication | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| executeInBackground : Boolean
Gibt an, ob die Anwendung im Hintergrund ausgeführt wird oder nicht. | NativeApplication | ||
| icon : InteractiveIcon [schreibgeschützt]
Das Anwendungssymbol. | NativeApplication | ||
| idleThreshold : int
Die Anzahl der Sekunden, die ohne Benutzereingabe verstreichen müssen, bevor ein userIdle-Ereignis ausgelöst wird. | NativeApplication | ||
| isCompiledAOT : Boolean [schreibgeschützt]
Gibt an, ob die App für die gewünschte Plattform kompiliert oder interpretiert wird. | NativeApplication | ||
| menu : NativeMenu
Das Anwendungsmenü. | NativeApplication | ||
| nativeApplication : NativeApplication [statisch] [schreibgeschützt]
Die Singleton-Instanz des NativeApplication-Objekts. | NativeApplication | ||
| openedWindows : Array [schreibgeschützt]
Ein Array, das alle geöffneten nativen Fenster dieser Anwendung enthält. | NativeApplication | ||
| publisherID : String [schreibgeschützt]
Die Veröffentlicher-ID dieser Anwendung. | NativeApplication | ||
| runtimePatchLevel : uint [schreibgeschützt]
Die Patchebene der Laufzeitumgebung, die diese Anwendung hostet. | NativeApplication | ||
| runtimeVersion : String [schreibgeschützt]
Die Versionsnummer der Laufzeitumgebung, die diese Anwendung hostet. | NativeApplication | ||
| startAtLogin : Boolean
Legt fest, ob diese Anwendung automatisch gestartet wird, wenn sich der aktuelle Benutzer anmeldet. | NativeApplication | ||
| supportsDefaultApplication : Boolean [statisch] [schreibgeschützt]
Gibt an, ob setAsDefaultApplication(), removeAsDefaultApplication() und isSetAsDefaultApplication() von der aktuellen Plattform unterstützt werden. | NativeApplication | ||
| supportsDockIcon : Boolean [statisch] [schreibgeschützt]
Gibt an, ob AIR Anwendungssymbol im Dock-Stil unter dem aktuellen Betriebssystem unterstützt. | NativeApplication | ||
| supportsMenu : Boolean [statisch] [schreibgeschützt]
Legt fest, ob das aktuelle Betriebssystem eine globale Anwendungsmenüleiste unterstützt. | NativeApplication | ||
| supportsStartAtLogin : Boolean [statisch] [schreibgeschützt]
Gibt an, ob startAtLogin von der aktuellen Plattform unterstützt wird. | NativeApplication | ||
| supportsSystemTrayIcon : Boolean [statisch] [schreibgeschützt]
Legt fest, ob AIR Infobereich-Symbole unter dem aktuellen Betriebssystem unterstützt. | NativeApplication | ||
| systemIdleMode : String
Bietet Anwendungen eine Möglichkeit zu verhindern, dass die Benutzeroberfläche in den „Leerlauf“ versetzt wird. | NativeApplication | ||
| timeSinceLastUserInput : int [schreibgeschützt]
Die Zeit in Sekunden seit der letzten Benutzereingabe. | NativeApplication | ||
| Methode | Definiert von | ||
|---|---|---|---|
Aktiviert diese Anwendung. | NativeApplication | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override]
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | NativeApplication | ||
Ruft einen internen Löschen-Befehl für das Anzeigeobjekt im Fokus auf. | NativeApplication | ||
Ruft einen internen Kopieren-Befehl für das Anzeigeobjekt im Fokus auf. | NativeApplication | ||
Ruft einen internen Ausschneiden-Befehl für das Anzeigeobjekt im Fokus auf. | NativeApplication | ||
[override]
Sendet ein Ereignis in den Ereignisablauf. | NativeApplication | ||
Beendet diese Anwendung. | NativeApplication | ||
Ruft die Standardanwendung zum Öffnen von Dateien mit der angegebenen Erweiterung ab. | NativeApplication | ||
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
Gibt an, ob diese Anwendung zurzeit die Standardanwendung zum Öffnen von Dateien mit der angegebenen Erweiterung ist. | NativeApplication | ||
Ruft einen internen Einfügen-Befehl für das Anzeigeobjekt im Fokus auf. | NativeApplication | ||
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
Entfernt diese Anwendung als Standardanwendung zum Öffnen von Dateien mit der angegebenen Erweiterung. | NativeApplication | ||
[override]
Entfernt einen Listener aus dem EventDispatcher-Objekt. | NativeApplication | ||
Ruft einen internen Alles-auswählen-Befehl für das Anzeigeobjekt im Fokus auf. | NativeApplication | ||
Legt diese Anwendung als Standardanwendung zum Öffnen von Dateien mit der angegebenen Erweiterung fest. | NativeApplication | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| Wird ausgelöst, wenn diese Anwendung die aktive Desktopanwendung wird. | NativeApplication | |||
| Wird ausgelöst, wenn die Anwendung durch eine SWF-Datei aufgerufen wird, die im Browser des Benutzers ausgeführt wird. | NativeApplication | |||
| Wird ausgelöst, wenn der Desktop-Fokus zu einer anderen Anwendung wechselt. | NativeApplication | |||
| Wird ausgelöst, wenn die Beenden-Sequenz der Anwendung eingeleitet wurde. | NativeApplication | |||
| Wird ausgelöst, wenn eine Anwendung aufgerufen wird. | NativeApplication | |||
| Wird ausgelöst, wenn der Benutzer eine Taste drückt. | NativeApplication | |||
| Wird ausgelöst, wenn der Benutzer eine Taste loslässt. | NativeApplication | |||
| Wird ausgelöst, wenn eine neue Netzwerkverbindung verfügbar wird oder wenn eine vorhandene Netzwerkverbindung unterbrochen wird. | NativeApplication | |||
| Wird abgesetzt, wenn die Anwendung gleich vom Betriebssystem in den Ruhezustand versetzt wird. | NativeApplication | |||
| Wird bei Inaktivität des Benutzers abgesetzt. | NativeApplication | |||
| Wird ausgelöst, wenn das Betriebssystem nach einer Inaktivitätsphase Maus- oder Tastaturaktivität erkennt. | NativeApplication | |||
activeWindow | Eigenschaft |
activeWindow:NativeWindow [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Das aktive Fenster der Anwendung.
Wenn das aktive Desktopfenster nicht zu dieser Anwendung gehört oder kein aktives Fenster vorhanden ist, weist activeWindow den Wert null auf.
Diese Eigenschaft wird auf Plattformen, die die NativeWindow-Klasse nicht unterstützen, nicht unterstützt.
Implementierung
public function get activeWindow():NativeWindow applicationDescriptor | Eigenschaft |
applicationDescriptor:XML [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Der Inhalt der Anwendungsdeskriptordatei für diese AIR-Anwendung.
Implementierung
public function get applicationDescriptor():XMLBeispiel ( Verwendung dieses Beispiels )
copyright und version aus der Anwendungsdeskriptordatei gelesen. Beachten Sie, dass Sie den Standard-Namespace verwenden müssen, der im XML-Code der Anwendungsdeskriptordatei definiert ist.
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 | Eigenschaft |
autoExit | Eigenschaft |
autoExit:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Legt fest, ob die Anwendung automatisch beendet wird, wenn alle Fenster geschlossen wurden.
Wenn autoExit den Wert true hat (Standardeinstellung), wird die Anwendung beendet, wenn alle Fenster geschlossen wurden. Es wird sowohl das exiting- als auch das exit-Ereignis ausgelöst. Wenn autoExit den Wert false hat, müssen Sie NativeApplication.nativeApplication.exit() aufrufen, um die Anwendung zu beenden.
Diese Eigenschaft wird auf Plattformen, die die NativeWindow-Klasse nicht unterstützen, nicht unterstützt.
Implementierung
public function get autoExit():Boolean public function set autoExit(value:Boolean):void executeInBackground | Eigenschaft |
executeInBackground:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3.3 |
Gibt an, ob die Anwendung im Hintergrund ausgeführt wird oder nicht.
Wenn executeInBackground den Wert false (die Standardeinstellung) hat, bleibt die Anwendung im Ruhezustand, wenn sie in den Hintergrund geschickt wird. Wenn executeInBackground den Wert true hat, kann die Anwendung im Hintergrund ausgeführt werden.
Hinweis: Für die SWF-Version 21 und die früheren Versionen davon, wird von AIR nicht die Ausführung im Hintergrund unter iOS und Android unterstützt, wenn der Rendermodus direkt festgelegt wird. Aufgrund dieser Einschränkung konnten Stage3D-basierte Apps keine Hintergrundaufgaben wie die Audiowiedergabe, die Suche nach Updates, das Hoch- und Herunterladen über das Netzwerk usw. ausführen. iOS lässt OpenGLES oder das Rendern von Aufrufen im Hintergrund nicht zu. Anwendungen, die versuchen OpenGL-Aufrufe im Hintergrund auszuführen, werden durch iOS beendet. Android verhindert nicht, dass Anwendungen OpenGLES-Aufrufe oder andere Aufgaben (wie die Audiowiedergabe) im Hintergrund ausführen. Bei der SWF-Version 22 und höher können AIR-Mobilanwendungen im Hintergrund ausgeführt werden, wenn der Rendermodus direkt festgelegt ist. Die AIR iOS-Laufzeit führt zu einem ActionScript-Fehler (3768 Das Stage3D API darf während der Ausführung im Hintergrund nicht verwendet werden), wenn OpenGLES-Aufrufe im Hintergrund ausgeführt werden. Es gibt jedoch keine Fehler auf Android, da die nativen Anwendungen OpenGLES-Aufrufe im Hintergrund ausführen können. Führen Sie zur optimalen Nutzung der mobilen Ressource keine Render-Aufrufe durch, wenn die Anwendung im Hintergrund ausgeführt wird.
Diese Eigenschaft wird unter AIR iOS und Android unterstützt.
Implementierung
public function get executeInBackground():Boolean public function set executeInBackground(value:Boolean):void icon | Eigenschaft |
icon:InteractiveIcon [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Das Anwendungssymbol.
Mit NativeApplication.supportsDockIcon und NativeApplication.supportsSystemTrayIcon können Sie die Symbolklasse festlegen. Der Typ ist eine der Unterklassen von InteractiveIcon. Unter Mac® OS X ist NativeApplication.icon ein Objekt vom Typ DockIcon. Unter Windows® ist NativeApplication.icon ein Objekt vom Typ SystemTrayIcon. Wenn ein Anwendungssymbol nicht unterstützt wird, sind NativeApplication.supportsDockIcon und NativeApplication.supportsSystemTrayIcon beide false und die icon-Eigenschaft ist null.
Das icon-Objekt wird automatisch erstellt, es wird jedoch nicht mit Bilddaten initialisiert. Unter manchen Betriebssystemen, z. B. Mac OS X, wird ein Standardbild bereitgestellt. Unter anderen, z. B. Windows, wird das Symbol erst angezeigt, wenn ihm Bilddaten zugewiesen werden. Um ein Symbolbild zuzuweisen, legen Sie für die icon.bitmaps-Eigenschaft ein Array fest, das mindestens ein BitmapData-Objekt enthält. Enthält das Array mehrere BitmapData-Objekte, wählt das Betriebssystem das Bild, dessen Größe den Abmessungen des Symbols am nächsten kommt, wobei das Bild bei Bedarf skaliert wird.
Implementierung
public function get icon():InteractiveIconVerwandte API-Elemente
idleThreshold | Eigenschaft |
idleThreshold:int| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Die Anzahl der Sekunden, die ohne Benutzereingabe verstreichen müssen, bevor ein userIdle-Ereignis ausgelöst wird.
Standardmäßig ist der Leerlaufwert auf 300 Sekunden (5 Minuten) eingestellt. Der Bereich der erlaubten Werte reicht von (einschließlich) 5 (5 Sekunden) bis 86.400 (ein Tag).
Implementierung
public function get idleThreshold():int public function set idleThreshold(value:int):voidAuslöser
ArgumentError — Wenn Sie versuchen, die Eigenschaft auf einen ungültigen Wert zu setzen. Der Bereich der erlaubten Werte reicht von (einschließlich) 5 (5 Sekunden) bis 86.400 (ein Tag).
|
Verwandte API-Elemente
isCompiledAOT | Eigenschaft |
isCompiledAOT:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 25.0 |
Gibt an, ob die App für die gewünschte Plattform kompiliert oder interpretiert wird. Diese API gibt (true) nur für iOS zurück (ipa-app-store, ipa-test, ipa-debug, ipa-ad-hoc). Für andere AIR-Plattformen gibt diese API (false) zurück.
Implementierung
public function get isCompiledAOT():Boolean menu | Eigenschaft |
menu:NativeMenu| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Das Anwendungsmenü.
Anwendungsmenüs werden unterstützt, wenn NativeApplication.supportsMenu true ist. Nicht alle Betriebssysteme unterstützen Anwendungsmenüs. Anwendungsmenüs werden zum Beispiel unter Mac OS X unterstützt, nicht jedoch unter Windows oder Linux. Das Zuweisen eines NativeMenu-Objekts zu dieser Eigenschaft, wenn NativeApplication.supportsMenu false ist, ist zwar zulässig, hat aber keine Auswirkungen. Sie müssen die NativeApplication.supportsMenu-Eigenschaft verwenden, um festzulegen, ob das Betriebssystem Fenstermenüs unterstützt. Die Verwendung anderer Vorgehensweisen (z. B. Capabilities.os) zur Festlegung der Unterstützung kann zu Programmierfehlern führen (beispielsweise dann, wenn mögliche Zielbetriebssysteme nicht berücksichtigt werden).
AIR-Profilunterstützung: Diese Funktion wird auf mobilen Geräten oder Geräten mit AIR für TV nicht unterstützt. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Hinweis: Unter Mac OS X verweist die Eigenschaft menu auf das vom Betriebssystem bereitgestellte Standardanwendungsmenü. Sie können die vorhandene Menüstruktur ändern, indem Sie Elemente und Untermenüs hinzufügen oder entfernen und indem Sie Ereignis-Listener hinzufügen. Sie können die Standardmenüs auch vollständig entfernen, indem Sie dieser menu-Eigenschaft ein neues NativeMenu-Objekt zuweisen.
Implementierung
public function get menu():NativeMenu public function set menu(value:NativeMenu):voidVerwandte API-Elemente
nativeApplication | Eigenschaft |
nativeApplication:NativeApplication [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Die Singleton-Instanz des NativeApplication-Objekts.
Implementierung
public static function get nativeApplication():NativeApplicationAuslöser
Error — Wenn der Zugriff durch Inhalte außerhalb der Sicherheitssandbox der Anwendung erfolgt.
|
openedWindows | Eigenschaft |
openedWindows:Array [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Ein Array, das alle geöffneten nativen Fenster dieser Anwendung enthält.
Diese Eigenschaft wird auf Plattformen, die die NativeWindow-Klasse nicht unterstützen, nicht unterstützt.
Implementierung
public function get openedWindows():Array publisherID | Eigenschaft |
publisherID:String [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Die Veröffentlicher-ID dieser Anwendung.
Der Wert dieser ID wird in der publisherid-Datei der Anwendung festgelegt. Diese Datei wird bei der Installation aus der Zertifikatskette, mit der die Anwendung signiert wird, generiert.
Implementierung
public function get publisherID():String runtimePatchLevel | Eigenschaft |
runtimeVersion | Eigenschaft |
startAtLogin | Eigenschaft |
startAtLogin:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Legt fest, ob diese Anwendung automatisch gestartet wird, wenn sich der aktuelle Benutzer anmeldet.
Unterstützung von AIR-Profilen: Diese Funktion wird auf allen Desktopbetriebssystemen unterstützt, jedoch nicht auf mobilen Geräten oder Geräten mit AIR für TV. Mit der NativeApplication.supportsStartAtLogin-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Die startAtLogin-Eigenschaft stellt den Status der vom Betriebssystem definierten Funktionalität dar, die festlegt, dass eine Anwendung automatisch gestartet wird, wenn sich ein Benutzer anmeldet. Der Benutzer kann den Status über die Benutzeroberfläche des Betriebsystems manuell ändern. Diese Eigenschaft stellt den aktuellen Status dar, unabhängig davon, ob er zuletzt von der AIR-Anwendung oder vom Betriebssystem geändert wurde.
Implementierung
public function get startAtLogin():Boolean public function set startAtLogin(value:Boolean):voidAuslöser
IllegalOperationError — Unter Windows, wenn eine andere Anwendung mit demselben Namen (aber einem anderen Pfad zur ausführbaren Datei) bereits gestartet wird, wenn sich der Benutzer anmeldet.
| |
IllegalOperationError — Wenn diese Anwendung nicht installiert ist, was der Fall sein kann, wenn sie vom AIR Debug Launcher (ADL) gestartet wurde.
|
Verwandte API-Elemente
supportsDefaultApplication | Eigenschaft |
supportsDefaultApplication:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 2 |
Gibt an, ob setAsDefaultApplication(), removeAsDefaultApplication() und isSetAsDefaultApplication() von der aktuellen Plattform unterstützt werden.
Bei dem Wert true funktionieren die oben genannten Methoden wie beschrieben. Bei dem Wert false sind setAsDefaultApplication() und removeDefaultApplication() ohne Auswirkungen und isSetAsDefaultApplication() gibt false zurück.
Implementierung
public static function get supportsDefaultApplication():BooleanVerwandte API-Elemente
supportsDockIcon | Eigenschaft |
supportsDockIcon:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Gibt an, ob AIR Anwendungssymbol im Dock-Stil unter dem aktuellen Betriebssystem unterstützt.
Wenn der Wert true lautet, hat die NativeApplication.icon-Eigenschaft den Typ DockIcon.
Die Benutzeroberfläche von Mac OS X verfügt über ein Anwendungs-„Dock“ mit Symbolen für Anwendungen, die zurzeit ausgeführt oder häufig verwendet werden.
Sie sollten die NativeApplication.supportsDockIcon-Eigenschaft verwenden, um festzulegen, ob das Betriebssystem Anwendungs-Dock-Symbole unterstützt. Die Verwendung anderer Vorgehensweisen (z. B. Capabilities.os) zur Festlegung der Unterstützung kann zu Programmierfehlern führen (beispielsweise dann, wenn mögliche Zielbetriebssysteme nicht berücksichtigt werden).
Implementierung
public static function get supportsDockIcon():BooleanVerwandte API-Elemente
supportsMenu | Eigenschaft |
supportsMenu:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Legt fest, ob das aktuelle Betriebssystem eine globale Anwendungsmenüleiste unterstützt.
Bei der Einstellung true kann mit der NativeApplication.menu-Eigenschaft ein natives Anwendungsmenü definiert bzw. auf dieses zugegriffen werden.
Sie sollten die NativeApplication.supportsMenu-Eigenschaft verwenden, um festzulegen, ob das Betriebssystem die Anwendungsmenüleiste unterstützt. Die Verwendung anderer Vorgehensweisen (z. B. Capabilities.os) zur Festlegung der Unterstützung kann zu Programmierfehlern führen (beispielsweise dann, wenn mögliche Zielbetriebssysteme nicht berücksichtigt werden).
Implementierung
public static function get supportsMenu():BooleanVerwandte API-Elemente
supportsStartAtLogin | Eigenschaft |
supportsStartAtLogin:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 2 |
Gibt an, ob startAtLogin von der aktuellen Plattform unterstützt wird.
Bei dem Wert true funktioniert startAtLogin wie beschrieben. Bei dem Wert false hat startAtLogin keine Auswirkungen.
Implementierung
public static function get supportsStartAtLogin():BooleanVerwandte API-Elemente
supportsSystemTrayIcon | Eigenschaft |
supportsSystemTrayIcon:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Legt fest, ob AIR Infobereich-Symbole unter dem aktuellen Betriebssystem unterstützt.
Wenn der Wert true lautet, hat die NativeApplication.icon-Eigenschaft den Typ SystemTrayIcon.
Die Windows-Benutzeroberfläche verfügt über den Infobereich („System Tray“) in der Taskleiste, in dem Anwendungssymbole angezeigt werden können. Es wird kein Standardsymbol angezeigt. Sie müssen das bitmaps-Array des Symbolobjekts festlegen, um ein Symbol anzuzeigen.
Sie sollten die NativeApplication.supportsSystemTrayIcon-Eigenschaft verwenden, um festzulegen, ob das Betriebssystem Infobereichsymbole unterstützt. Die Verwendung anderer Vorgehensweisen (z. B. Capabilities.os) zur Festlegung der Unterstützung kann zu Programmierfehlern führen (beispielsweise dann, wenn mögliche Zielbetriebssysteme nicht berücksichtigt werden).
Implementierung
public static function get supportsSystemTrayIcon():BooleanVerwandte API-Elemente
systemIdleMode | Eigenschaft |
systemIdleMode:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 2 |
Bietet Anwendungen eine Möglichkeit zu verhindern, dass die Benutzeroberfläche in den „Leerlauf“ versetzt wird.
Ein Wert aus der SystemIdleMode-Klasse, um das Verhalten des Hostsystems im Leerlauf zu beeinflussen. Diese Eigenschaft wirkt sich nur auf die Anwendung mit dem Eingabefokus aus; und nur Inhalt, der in der Anwendungssandbox ausgeführt wird, kann auf diese Eigenschaft zugreifen.
Unterstützung von AIR-Profilen: Diese Funktion wird auf mobilen Geräten unterstützt, nicht jedoch auf Desktopbetriebssystemen oder Geräten mit AIR für TV. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Implementierung
public function get systemIdleMode():String public function set systemIdleMode(value:String):voidVerwandte API-Elemente
timeSinceLastUserInput | Eigenschaft |
activate | () | Methode |
public function activate(window:NativeWindow = null):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Aktiviert diese Anwendung.
Diese Methode wird auf Plattformen, die die NativeWindow-Klasse nicht unterstützen, nicht unterstützt.
Unter Umständen, die vom Betriebssystem bestimmt werden, aktiviert diese Methode eine Anwendung nicht. Die meisten Betriebssysteme schränken die Möglichkeiten einer Anwendung, sich selbst zu aktivieren, ein. Damit soll verhindert werden, dass es die Anwendung dem Benutzer (absichtlich oder nicht) unmöglich macht, andere Anwendungen zu verwenden.
Wenn das Betriebssystem die Aktivierung zulässt, wird das festgelegte Fenster aktiviert und im Vordergrund des Desktops angezeigt, d. h. vor Fenstern anderer Anwendungen. (Wenn der window-Parameter den Wert null aufweist, wird jedes sichtbare Fenster dieser Anwendung aktiviert.)
Die activate()-Methode hat keine Auswirkungen, wenn die Anwendung keine sichtbaren Fenster hat.
Der Aktivierungsvorgang ist ein synchroner Vorgang.
Parameter
window:NativeWindow (default = null) |
Ereignisse
activate: — Wird ausgelöst, wenn sich der Aktivierungsstatus ändert.
|
addEventListener | () | Methode |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void| Laufzeitversionen: | AIR 1.0 |
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. Sie können Ereignis-Listener bei allen Knoten in der Anzeigeliste für eine bestimmte Art von Ereignis, Phase oder Priorität registrieren.
Nachdem Sie einen Ereignis-Listener erfolgreich registriert haben, können Sie seine Priorität nicht durch weitere Aufrufe von addEventListener() ändern. Um die Priorität eines Listeners zu ändern, müssen Sie zunächst removeListener() aufrufen. Anschließend können Sie den Listener mit der neuen Prioritätsstufe erneut aufrufen.
Nach der Registrierung des Listeners haben nachfolgende Aufrufe von addEventListener() mit einem anderen type- oder useCapture-Wert eine separate Listener-Registrierung zur Folge. Wenn Sie beispielsweise zuerst einen Listener registrieren, für den useCapture auf true gesetzt ist, wird dieser nur während der Aufnahmephase aktiv sein. Wenn Sie addEventListener() für dasselbe Listener-Objekt erneut aufrufen, diesmal aber useCapture auf false gesetzt ist, werden zwei separate Listener angelegt: einer, der während der Aufnahmephase aktiv ist und ein zweiter, der während der Ziel- und Bubbling-Phase aktiv ist.
Sie können einen Ereignis-Listener nicht nur für die Ziel- oder Bubbling-Phase registrieren. Die beiden Phasen hängen während der Registrierung immer zusammen, da Bubbling nur für übergeordnete Elemente des Zielknotens gilt.
Wenn Sie einen Ereignis-Listener nicht mehr brauchen, entfernen sie ihn, indem Sie removeEventListener() aufrufen. Andernfalls könnte es zu Speicherproblemen kommen. Ereignis-Listener werden nicht automatisch aus dem Speicher entfernt, da der Garbage Collector den Listener nicht entfernt, solange das auslösende Objekt vorhanden ist (sofern der useWeakReference-Parameter auf true gesetzt ist).
Beim Kopieren einer EventDispatcher-Instanz werden zugewiesene Ereignis-Listener nicht kopiert. (Wenn ein neu angelegter Knoten einen Ereignis-Listener benötigt, müssen Sie den Listener nach dem Erstellen des Knotens zuweisen.) Wenn Sie jedoch eine EventDispatcher-Instanz verschieben, werden zugewiesene Ereignis-Listener ebenfalls verschoben.
Wenn der Ereignis-Listener bei einem Knoten registriert wird, während mit diesem Knoten ein Ereignis durchgeführt wird, so wird der Ereignis-Listener während der aktuellen Phase nicht ausgelöst, kann aber während einer späteren Phase im Ereignisablauf ausgelöst werden, etwa während der Bubbling-Phase.
Wird ein Ereignis-Listener von einem Knoten entfernt, während mit dem Knoten ein Ereignis durchgeführt wird, so wird er von den aktuellen Aktionen immer noch ausgelöst. Nachdem er entfernt worden ist, wird der Ereignis-Listener nicht wieder aufgerufen (es sei denn er wird für spätere Verarbeitungsvorgänge erneut aufgerufen).
Parameter
type:String — Der Ereignistyp.
| |
listener:Function — Die Listener-Funktion, die das Ereignis verarbeitet. Diese Funktion muss ein Ereignisobjekt als einzigen Parameter akzeptieren und darf keinen Wert zurückgeben, wie das nachfolgende Beispiel zeigt:
function(evt:Event):void Der Name der Funktion ist beliebig. | |
useCapture:Boolean (default = false)useCapture auf true gesetzt, so verarbeitet der Listener das Ereignis nur während der Erfassungsphase und nicht während der Ziel- oder Bubbling-Phase. Hat useCapture hingegen den Wert false, verarbeitet der Listener das Ereignis nur während der Ziel- oder Bubbling-Phase. Um auf das Ereignis in allen drei Phasen zu warten, rufen Sie addEventListener() zweimal auf; einmal ist useCapture auf true gesetzt, und beim zweiten Mal hat useCapture den Wert false.
| |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false)Funktionen von Mitgliedern auf Klassenebene werden nicht vom Garbagekollektor entfernt. Daher können Sie |
clear | () | Methode |
public function clear():Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Ruft einen internen Löschen-Befehl für das Anzeigeobjekt im Fokus auf.
Dieser Funktionsaufruf wird ignoriert, wenn das Objekt im Fokus den Befehl nicht implementiert. Derzeit implementieren nur Anzeigeobjekte, die von der TextField- oder HTMLLoader-Klasse abgeleitet sind, diesen Befehl.
Hinweis: Der clear()-Befehl löscht ausgewählten Text. Wenn nichts ausgewählt ist, wird nicht der gesamte Text gelöscht.
Boolean — true.
|
copy | () | Methode |
public function copy():Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Ruft einen internen Kopieren-Befehl für das Anzeigeobjekt im Fokus auf.
Dieser Funktionsaufruf wird ignoriert, wenn die Komponente den Befehl nicht implementiert. Derzeit implementieren nur Anzeigeobjekte, die von der TextField- oder HTMLLoader-Klasse abgeleitet sind, diesen Befehl.
RückgabewerteBoolean |
cut | () | Methode |
public function cut():Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Ruft einen internen Ausschneiden-Befehl für das Anzeigeobjekt im Fokus auf.
Dieser Funktionsaufruf wird ignoriert, wenn die Komponente den Befehl nicht implementiert. Derzeit implementieren nur Anzeigeobjekte, die von der TextField- oder HTMLLoader-Klasse abgeleitet sind, diese Befehle.
RückgabewerteBoolean — true.
|
dispatchEvent | () | Methode |
override public function dispatchEvent(event:Event):Boolean| Laufzeitversionen: | AIR 1.0 |
Sendet ein Ereignis in den Ereignisablauf. Das Ereignisziel ist das EventDispatcher-Objekt, für das die Methode dispatchEvent() aufgerufen wird.
Parameter
event:Event — Das Ereignisobjekt, das in den Ereignisablauf integriert wird. Wenn das Ereignis erneut gesendet wird, wird automatisch ein Klon des Ereignisses erstellt. Nachdem ein Ereignis ausgelöst wurde, lässt sich seine target-Eigenschaft nicht mehr ändern, daher funktioniert ein Zurücksenden des Ereignisses nur, wenn Sie eine neue Kopie des Ereignisses erstellen.
|
Boolean — Der Wert true, wenn das Ereignis erfolgreich ausgelöst wurde. Der Wert false weist entweder auf einen Fehler hin oder auf die Tatsache, dass preventDefault() für das Ereignis aufgerufen worden ist.
|
exit | () | Methode |
public function exit(errorCode:int = 0):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Beendet diese Anwendung.
Der Aufruf der exit()-Methode erfolgt erneut; die Beenden-Sequenz beginnt erst, wenn der zurzeit ausgeführte Code (zum Beispiel eine Ereignisprozedur) abgeschlossen ist. Ausstehende asynchrone Vorgänge werden abgebrochen, egal, ob sie abgeschlossen sind oder nicht.
Beachten Sie, dass kein exiting-Ereignis ausgelöst wird. Wenn die Anwendungslogik ein exiting-Ereignis erfordert, rufen Sie NativeApplication.nativeApplication.dispatchEvent() auf und übergeben Sie in Ereignisobjekt des Typs exiting. Für geöffnete Fenster setzen NativeWindow-Objekte closing- und close-Ereignisse ab. Der Aufruf der preventDefault()-Methode des closing-Ereignisobjekts verhindert das Schließen der Anwendung.
Hinweis: Diese Methode wird vom iOS-Betriebssystem nicht unterstützt.
Parameter
errorCode:int (default = 0) |
getDefaultApplication | () | Methode |
public function getDefaultApplication(extension:String):String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Ruft die Standardanwendung zum Öffnen von Dateien mit der angegebenen Erweiterung ab.
Hinweis: Diese Methode kann nur mit Dateitypen, die in der fileTypes-Anweisung des Anwendungsdeskriptors deklariert sind, verwendet werden.
Diese Methode gilt nicht für Geräte mit AIR für TV. Wenn Sie sie mit einem Dateityp aufrufen, der im Anwendungsdeskriptor deklariert wird, wird null zurückgegeben.
Parameter
extension:String — Ein String mit der Erweiterung des relevanten Dateityps (ohne „.“).
|
String — Der Pfad der Standardanwendung
|
Auslöser
Error — Wenn der extension-Parameter keine der Dateierweiterungen enthält, die im Anwendungsdeskriptor deklariert sind.
|
Verwandte API-Elemente
isSetAsDefaultApplication | () | Methode |
public function isSetAsDefaultApplication(extension:String):Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Gibt an, ob diese Anwendung zurzeit die Standardanwendung zum Öffnen von Dateien mit der angegebenen Erweiterung ist.
Unterstützung von AIR-Profilen: Diese Funktion wird auf allen Desktopbetriebssystemen unterstützt, jedoch nicht auf mobilen Geräten oder Geräten mit AIR für TV. Mit der NativeApplication.supportsDefaultApplication-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Parameter
extension:String — Ein String mit der Erweiterung des relevanten Dateityps (ohne „.“).
|
Boolean — true, wenn diese Anwendung die Standardanwendung ist.
|
Auslöser
Error — Wenn der extension-Parameter keine der Dateierweiterungen enthält, die im Anwendungsdeskriptor deklariert sind.
|
Verwandte API-Elemente
paste | () | Methode |
public function paste():Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Ruft einen internen Einfügen-Befehl für das Anzeigeobjekt im Fokus auf.
Dieser Funktionsaufruf wird ignoriert, wenn die Komponente den Befehl nicht implementiert. Derzeit implementieren nur Anzeigeobjekte, die von der TextField- oder HTMLLoader-Klasse abgeleitet sind, diesen Befehl.
RückgabewerteBoolean — true.
|
removeAsDefaultApplication | () | Methode |
public function removeAsDefaultApplication(extension:String):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Entfernt diese Anwendung als Standardanwendung zum Öffnen von Dateien mit der angegebenen Erweiterung.
Hinweis: Diese Methode kann nur mit Dateitypen, die in der fileTypes-Anweisung im Anwendungsdeskriptors deklariert sind, verwendet werden.
Parameter
extension:String — Ein String mit der Erweiterung des relevanten Dateityps (ohne „.“).
|
Auslöser
Error — Wenn der extension-Parameter keine der Dateierweiterungen enthält, die im Anwendungsdeskriptor deklariert sind.
|
Verwandte API-Elemente
removeEventListener | () | Methode |
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void| Laufzeitversionen: | AIR 1.0 |
Entfernt einen Listener aus dem EventDispatcher-Objekt. Wenn kein entsprechender Listener mit dem EventDispatcher-Objekt registriert ist, hat ein Aufruf dieser Methode keine Auswirkungen.
Parameter
type:String — Der Ereignistyp.
| |
listener:Function — Das zu entfernende Listener-Objekt.
| |
useCapture:Boolean (default = false)removeEventListener() erforderlich, um beide zu entfernen: ein Aufruf, bei dem useCapture auf true gesetzt ist, und einer, bei dem useCapture auf false gesetzt ist.
|
selectAll | () | Methode |
public function selectAll():Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Ruft einen internen Alles-auswählen-Befehl für das Anzeigeobjekt im Fokus auf.
Dieser Funktionsaufruf wird ignoriert, wenn die Komponente den Befehl nicht implementiert. Derzeit implementieren nur Anzeigeobjekte, die von der TextField- oder HTMLLoader-Klasse abgeleitet sind, diesen Befehl.
RückgabewerteBoolean — true.
|
setAsDefaultApplication | () | Methode |
public function setAsDefaultApplication(extension:String):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Legt diese Anwendung als Standardanwendung zum Öffnen von Dateien mit der angegebenen Erweiterung fest.
Hinweis: Diese Methode kann nur mit Dateitypen, die in der fileTypes-Anweisung im Anwendungsdeskriptors deklariert sind, verwendet werden.
Parameter
extension:String — Ein String mit der Erweiterung des relevanten Dateityps (ohne „.“).
|
Auslöser
Error — Wenn der extension-Parameter keine der Dateierweiterungen enthält, die im Anwendungsdeskriptor deklariert sind.
|
Verwandte API-Elemente
activate | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.ACTIVATE| Laufzeitversionen: | AIR 1.0 |
Wird ausgelöst, wenn diese Anwendung die aktive Desktopanwendung wird.
DieACTIVATE-Konstante bestimmt den Wert der type-Eigenschaft eines activate-Ereignisobjekts.
Hinweis: Dieses Ereignis verfügt weder über eine Aufnahmephase noch über eine Bubbling-Phase. Das bedeutet, dass Ereignis-Listener potenziellen Zielen direkt hinzugefügt werden müssen, unabhängig davon, ob sich das Ziel in der Anzeigeliste befindet oder nicht.
AIR für TV setzt dieses Ereignis niemals ab. Sie können es jedoch manuell absetzen.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Jede DisplayObject-Instanz, die einen Listener besitzt, der für das activate-Ereignis registriert ist. |
browserInvoke | Ereignis |
flash.events.BrowserInvokeEventEigenschaft BrowserInvokeEvent.type =
flash.events.BrowserInvokeEvent.Browser_INVOKE| Laufzeitversionen: | AIR 1.0 |
Wird ausgelöst, wenn die Anwendung durch eine SWF-Datei aufgerufen wird, die im Browser des Benutzers ausgeführt wird.
Der Aufruf durch den Browser ist nur dann zulässig, wenn in der Anwendungsdeskriptordatei einer Anwendung Folgendes angegeben ist:
<allowBrowserInvocation>true</allowBrowserInvocation>
deactivate | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.DEACTIVATE| Laufzeitversionen: | AIR 1.0 |
Wird ausgelöst, wenn der Desktop-Fokus zu einer anderen Anwendung wechselt.
DieEvent.DEACTIVATE-Konstante definiert den Wert der type-Eigenschaft eines deactivate-Ereignisobjekts.
Hinweis: Dieses Ereignis verfügt weder über eine Aufnahmephase noch über eine Bubbling-Phase. Das bedeutet, dass Ereignis-Listener potenziellen Zielen direkt hinzugefügt werden müssen, unabhängig davon, ob sich das Ziel in der Anzeigeliste befindet oder nicht.
AIR für TV setzt dieses Ereignis niemals ab. Sie können es jedoch manuell absetzen.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Jede DisplayObject-Instanz, die einen Listener besitzt, der für das deactivate-Ereignis registriert ist. |
exiting | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.EXITING| Laufzeitversionen: | AIR 1.0 |
Wird ausgelöst, wenn die Beenden-Sequenz der Anwendung eingeleitet wurde.
Das exiting-Ereignis wird ausgelöst, wenn das Beenden der Anwendung vom Betriebssystem eingeleitet wurde, zum Beispiel, wenn der Benutzer unter Mac OS X die Tastenkombination Cmd-Q verwendet oder wenn die autoExit-Eigenschaft des NativeApplication-Objekts true ist und das letzte Anwendungsfenster geschlossen wird. Beim Abbrechen dieses Ereignisses wird die Anwendung nicht beendet.
AIR für TV setzt das exiting-Ereignis niemals ab.
Hinweis: Beim Aufrufen der exit()-Methode von NativeApplication wird kein exiting-Ereignis ausgelöst. Wenn eine Anwendung Komponenten über das bevorstehende Beenden informieren soll, sollte das exiting-Ereignis vor dem Aufruf von exit() abgesetzt werden.
Event.EXITING-Konstante definiert den Wert der type-Eigenschaft eines exiting-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | true; das Abbrechen dieses Ereignisobjekts stoppt den Beenden-Vorgang. |
currentTarget | Das NativeApplication-Objekt. |
target | Das NativeApplication-Objekt. |
invoke | Ereignis |
flash.events.InvokeEventEigenschaft InvokeEvent.type =
flash.events.InvokeEvent.INVOKE| Laufzeitversionen: | AIR 1.0 |
Wird ausgelöst, wenn eine Anwendung aufgerufen wird.
Wenn eine Anwendung ein zweites Mal aufgerufen wird, wird keine weitere Instanz der Anwendung gestartet. Stattdessen erhält die erste Instanz ein zusätzliches Aufrufereignis. Die Anwendung ist dafür zuständig, weitere invoke-Ereignisse entsprechend zu behandeln.
Hinweis: Alle invoke-Ereignisse werden in eine Warteschlange gestellt. Wenn ein Listener für dieses Ereignis registriert ist, erhält er alle Ereignisse in der Warteschlange sowie alle neuen Ereignisse. In die Warteschlange gestellte Ereignisse können vor oder nach neuen invoke-Ereignissen ausgegeben werden.
InvokeEvent.INVOKE-Konstante definiert den Wert der type-Eigenschaft eines InvokeEvent-Objekts.
Das InvokeEvent-Ereignisobjekt hat folgende Eigenschaften:
| Eigenschaften | Werte |
|---|---|
Arguments | Das Array von Stringargumenten, die während dieses Aufrufs übergeben werden. |
currentDirectory | ein File-Objekt, das den Ordner darstellt, der für die Auflösung relativer Pfade im Argumentarray verwendet wird. |
reason | ein Code, der angibt, ob das Aufrufereignis abgesetzt wurde, weil die Anwendung beim Anmelden automatisch gestartet wurde (InvokeEventReason.LOGIN), als Reaktion auf eine Remotebenachrichtigung gestartet wurde (InvokeEventReason.NOTIFICATION - nur iOS), weil die Anwendung von einer anderen Anwendung aufgerufen wurde (InvokeEventReason.OPEN_URL) oder aus einem anderen Grund (InvokeEventReason.STANDARD). Verfügbar ab AIR 1.5.1. |
bubbles | false. |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Gibt das Objekt an, welches das InvokeEvent -Objekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Immer das NativeApplication-Objekt. |
keyDown | Ereignis |
flash.events.KeyboardEventEigenschaft KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Wird ausgelöst, wenn der Benutzer eine Taste drückt. Die NativeApplication-Instanz stellt dieses Ereignis bereit, um Tasturkurzbefehle zu unterstützen. Dieses Tastaturereignis wird zuerst an die NativeApplication abgesetzt. Beim Abbrechen dieses Ereignisses werden auch NativeWindow-Menükurzbefehle abgebrochen. Dieses Ereignis tritt vor dem keyUp-Ereignis ein.
KeyboardEvent.KEY_DOWN-Konstante definiert den Wert der type-Eigenschaft eines keyDown-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | true |
cancelable | Wert true in AIR, Wert false in Flash Player; in AIR wird durch Abbrechen dieses Ereignisses verhindert, dass das Zeichen in ein Textfeld eingegeben wird. |
charCode | Der Zeichencodewert der gedrückten bzw. losgelassenen Taste. |
commandKey | true unter Mac, wenn die Befehlstaste aktiviert ist. Andernfalls wird false zurückgegeben |
controlKey | true unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac, wenn die Ctrl-Taste aktiviert ist. Andernfalls wird false zurückgegeben |
ctrlKey | true unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
keyCode | Der Tastencodewert der gedrückten bzw. losgelassenen Taste. |
KeyLocation | Die Position der Taste auf der Tastatur. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
target | Die InteractiveObject-Instanz mit dem Fokus. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
Verwandte API-Elemente
keyUp | Ereignis |
flash.events.KeyboardEventEigenschaft KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Wird ausgelöst, wenn der Benutzer eine Taste loslässt. Die NativeApplication-Instanz stellt dieses Ereignis bereit, um Tasturkurzbefehle zu unterstützen. Dieses Tastaturereignis wird zuerst an die NativeApplication abgesetzt. Das Abbrechen dieses Ereignisses hat keine Auswirkungen auf andere Objekte (zum Beispiel NativeWindow-Menükurzbefehle). Dieses Ereignis tritt nach einem keyDown-Ereignis auf.
KeyboardEvent.KEY_UP-Konstante definiert den Wert der type-Eigenschaft eines keyUp-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | true |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
charCode | Enthält den Zeichencodewert der gedrückten bzw. losgelassenen Taste. |
commandKey | true unter Mac, wenn die Befehlstaste aktiviert ist. Andernfalls wird false zurückgegeben |
controlKey | true unter Windows und Linux, wenn die Strg-Taste aktiv ist. true unter Mac, wenn die Ctrl-Taste aktiviert ist. Andernfalls wird false zurückgegeben |
ctrlKey | true unter Windows, falls die Strg-Taste aktiv ist. true unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird false zurückgegeben. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
keyCode | Der Tastencodewert der gedrückten bzw. losgelassenen Taste. |
KeyLocation | Die Position der Taste auf der Tastatur. |
shiftKey | true, wenn die Umschalttaste aktiv ist; false, wenn sie nicht aktiv ist. |
target | Die InteractiveObject-Instanz mit dem Fokus. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
Verwandte API-Elemente
networkChange | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.NETWORK_CHANGE| Laufzeitversionen: | AIR 1.0 |
Wird ausgelöst, wenn eine neue Netzwerkverbindung verfügbar wird oder wenn eine vorhandene Netzwerkverbindung unterbrochen wird.
Ein networkChange-Ereignis bedeutet nicht unbedingt, dass der Hostcomputer online oder offline gebracht wurde. Möglicherweise erfolgt nur ein Übergang von einem Verbindungstyp zu einem anderen. Anwendungen können mit diesem Ereignis dazu beitragen, die Überwachung der Verfügbarkeit von Remoteressourcen zu optimieren. Wenn ein networkChange-Ereignis ausgelöst wird, ist die ein guter Zeitpunkt, um die Verfügbarkeit von Remoteressourcen zu überprüfen.
Hinweise:
- Zwischen dem Auftreten einer Netzwerkänderung und diesem Ereignis kann es eine kurze Verzögerung geben.
- Unter Android kann das NativeApplication-Objekt mehrere networkChange-Ereignisse für jede Änderung bei einer Netzwerkverbindung absetzen.
Event.NETWORK_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines networkChange-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das NativeApplication-Objekt. |
suspend | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.SUSPEND| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 3.3 |
Wird abgesetzt, wenn die Anwendung gleich vom Betriebssystem in den Ruhezustand versetzt wird.
DieEvent.SUSPEND-Konstante definiert den Wert der type-Eigenschaft eines suspend-Ereignisobjekts. Dieses Ereignis wird nur unter AIR iOS abgesetzt.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das NativeApplication-Objekt. |
target | Das NativeApplication-Objekt. |
userIdle | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.USER_IDLE| Laufzeitversionen: | AIR 1.0 |
Wird bei Inaktivität des Benutzers abgesetzt.
Geben Sie mithilfe der idleThreshold-Eigenschaft an, wie lange ein Benutzer inaktiv sein muss, bevor dieses Ereignis abgesetzt wird. Die bisherige Dauer der Inaktivitätsphase kann anhand der timeSinceLastUserInput-Eigenschaft festgestellt werden.
Hinweis: Dieses Ereignis wird auf mobilen Geräten oder auf Geräten mit AIR für TV nicht abgesetzt.
DieEvent.USER_IDLE-Konstante definiert den Wert der type-Eigenschaft eines userIdle-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
target | Das NativeApplication-Objekt. |
Verwandte API-Elemente
userPresent | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.USER_PRESENT| Laufzeitversionen: | AIR 1.0 |
Wird ausgelöst, wenn das Betriebssystem nach einer Inaktivitätsphase Maus- oder Tastaturaktivität erkennt.
Hinweis: Dieses Ereignis wird auf mobilen Geräten oder auf Geräten mit AIR für TV nicht abgesetzt.
Wie lang die Inaktivitätsphase dazu sein muss, kann mit der idleThreshold-Eigenschaft festgelegt werden. Die bisherige Dauer der Inaktivitätsphase kann anhand der timeSinceLastUserInput-Eigenschaft festgestellt werden.
Event.USER_PRESENT-Konstante definiert den Wert der type-Eigenschaft eines userPresent-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
target | Das NativeApplication-Objekt. |
Verwandte API-Elemente
Tue Jun 12 2018, 10:04 AM Z