NativeApplication  - AS3

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.

Der Inhalt der Anwendungsdeskriptordatei für diese AIR-Anwendung.

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

Die Anwendungs-ID dieser Anwendung.

Der Wert dieser ID wird in der Anwendungsdeskriptordatei festgelegt.

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.

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.

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.

Verwandte API-Elemente

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

Verwandte API-Elemente

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.

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.

Verwandte API-Elemente

Die Singleton-Instanz des NativeApplication-Objekts.

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.

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.

Die Patchebene der Laufzeitumgebung, die diese Anwendung hostet.

Die Versionsnummer der Laufzeitumgebung, die diese Anwendung hostet.

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.

Verwandte API-Elemente

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.

Verwandte API-Elemente

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

Verwandte API-Elemente

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

Verwandte API-Elemente

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.

Verwandte API-Elemente

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

Verwandte API-Elemente

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.

Verwandte API-Elemente

Die Zeit in Sekunden seit der letzten Benutzereingabe.

Verwandte API-Elemente

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

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

function(evt:Event):void

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.

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.

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.

Sendet ein Ereignis in den Ereignisablauf. Das Ereignisziel ist das EventDispatcher-Objekt, für das die Methode dispatchEvent() aufgerufen wird.

Parameter

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

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

Verwandte API-Elemente

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

Verwandte API-Elemente

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.

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

Verwandte API-Elemente

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

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.

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

Verwandte API-Elemente

Wird ausgelöst, wenn diese Anwendung die aktive Desktopanwendung wird.

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:

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>

Wird ausgelöst, wenn der Desktop-Fokus zu einer anderen Anwendung wechselt.

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:

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.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

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.

Das InvokeEvent-Ereignisobjekt hat folgende Eigenschaften:

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.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

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.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

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.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird abgesetzt, wenn die Anwendung gleich vom Betriebssystem in den Ruhezustand versetzt wird.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

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.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

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.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente