Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Aufrufen und Beenden von AIR-Anwendungen
Anwendungen sollten keine BrowserInvokeEvent-Argumente verwenden, die auf lokale Ressourcen verweisen. So
darf eine Anwendung keine File-Objekte erstellen, die auf einem Pfad basieren, der vom Browser übergeben wurde.
Wird davon ausgegangen, das Remote-Pfadangaben vom Browser übergeben werden, muss die Anwendung
sicherstellen, dass diese Pfadangaben nicht das Protokoll file:// anstelle eines Remote-Protokolls verwenden.
Schließen der Anwendung
Adobe AIR 1.0 und höher
Eine Anwendung lässt sich am schnellsten mit einem Aufruf der exit()-Methode des NativeApplication-Objekts
schließen. Dies funktioniert problemlos, wenn die Anwendung keine Daten speichern oder externe Ressourcen
bereinigen muss. Durch den Aufruf von exit() werden alle Fenster geschlossen und die Anwendung wird beendet.
Um jedoch den Fenstern und anderen Anwendungskomponenten die Möglichkeit zu geben, den Vorgang zu
unterbrechen, z. B. um wichtige Daten zu speichern, lösen Sie vor dem Aufruf von exit() die entsprechenden
Warnereignisse aus.
Es ist sinnvoll, das Verlassen einer Anwendung so zu gestalten, dass die Ausführung immer gleich abläuft, unabhängig
davon, wie der Beendigungsvorgang gestartet wurde. Der Benutzer (oder das Betriebssystem) kann die Beendigung
der Anwendung auf folgende Arten einleiten:
Durch Schließen des letzten Anwendungsfensters, wenn NativeApplication.nativeApplication.autoExit
auf true gesetzt ist.
Durch Auswahl des Befehls „Schließen“ im Betriebssystem, wenn der Benutzer zum Beispiel den Befehl für das
Schließen der Anwendung aus dem Standardmenü wählt. (Dies geschieht nur auf Mac-Betriebssystemen.
Windows und Linux stellen keinen Befehl für das Schließen der Anwendung über die Benutzeroberfläche des
Systems zur Verfügung.)
Durch Herunterfahren des Computers.
Wenn der Befehl zum Schließen vom Betriebssystem über eines dieser Verfahren geleitet wird, löst NativeApplication
ein exiting-Ereignis aus. Wird dieses exiting-Ereignis nicht von einem Listener unterbrochen, werden alle offenen
Fenster geschlossen. Jedes Fenster löst ein closing- und dann ein close-Ereignis aus. Unterbricht eines der Fenster
das closing-Ereignis, wird das Schließen der Anwendung gestoppt.
Wenn die Reihenfolge, in der die Fenster geschlossen werden, für die Anwendung wichtig ist, richten Sie einen
Listener für das Ereignis exiting von NativeApplication ein und schließen Sie die Fenster eigenhändig in der
richtigen Reihenfolge. Dies ist zum Beispiel erforderlich, wenn ein Dokumentfenster mit Werkzeugpaletten
vorhanden ist. Es hat vielleicht unangenehme oder noch schlimmere Folgen, wenn das System die Paletten schließt,
der Benutzer jedoch beschlossen hat, den Beendigungsvorgang zu unterbrechen, um Daten zu speichern. Unter
Windows tritt das Ereignis exiting nur auf, nachdem das letzte Fenster geschlossen wurde (wenn die Eigenschaft
autoExit des NativeApplication-Objekts auf true gesetzt wurde).
Stellen Sie bei allen Schließvorgängen, gleichgültig ob Sie über die Oberfläche des Betriebssystems, Menübefehle oder
die Anwendungslogik ausgelöst wurden, sicher, dass der Vorgang gleich abläuft, indem Sie folgende Regeln beachten:
1 Lösen Sie ein exiting-Ereignis immer durch das NativeApplication-Objekt aus, bevor Sie im Anwendungscode
exit() aufrufen, und prüfen Sie, dass andere Komponenten der Anwendung das Ereignis nicht abbrechen.
Letzte Aktualisierung 27.6.2012
939