Das folgende Diagramm verdeutlicht das Verhältnis zwischen der JavaScript-Umgebung und der AIR-Laufzeitumgebung. Es wird nur ein einzelnes natives Fenster dargestellt, eine AIR-Anwendung kann jedoch mehrere Fenster umfassen. (Einzelne Fenster können zudem mehrere HTMLLoader-Objekte enthalten.)
Grafik in Originalgröße anzeigen
Die JavaScript-Umgebung verfügt über ihre eigenen Document- und Window-Objekte. Der JavaScript-Code kann über die Laufzeit-, NativeWindow- und htmlLoader-Eigenschaften mit der AIR-Laufzeitumgebung interagieren. ActionScript-Code kann mit der JavaScript-Umgebung über die window
-Eigenschaft eines HTMLLoader-Objekts, das auf ein Window-Objekt von JavaScript verweist, interagieren. Zudem können sowohl ActionScript- als auch JavaScript-Objekte als Listener für AIR- oder JavaScript-Ereignisse verwendet werden.
Die Eigenschaft
runtime
ermöglicht den Zugriff auf AIR-API-Klassen und gibt Ihnen damit die Möglichkeit, neue AIR-Objekte zu erstellen und auf Klassenmitglieder (auch als statische Mitglieder bezeichnet) zuzugreifen. Um auf eine AIR-API zuzugreifen, fügen Sie den Namen der Klasse zusammen mit dem Packet zur Eigenschaft
runtime
hinzu. Zur Erstellung eines File-Objekts geben Sie zum Beispiel die folgende Anweisung ein:
var file = new window.runtime.filesystem.File();
Hinweis:
Das AIR-SDK stellt eine JavaScript-Datei (
AIRAliases.js
) zur Verfügung, in der geeignete Aliasnamen für die am häufigsten verwendeten AIR-Klassen definiert werden. Wenn Sie diese Datei importieren, können Sie anstatt des umständlichen „window.runtime.package.Class“ das einfachere „air.Class“ verwenden. So können Sie beispielsweise mit
new air.File()
das File-Objekt erstellen.
Das NativeWindow-Objekt enthält Eigenschaften zur Steuerung des Desktop-Fensters. Auf dieses NativeWindow-Objekt können Sie mit der Eigenschaft
window.nativeWindow
aus einer HTML-Seite heraus zugreifen.
Das HTMLLoader-Objekt stellt Eigenschaften, Methoden und Ereignisse bereit, mit denen das Laden und die Wiedergabe von Inhalten gesteuert wird. Auf das übergeordnete HTMLLoader-Objekt können Sie mit der Eigenschaft
window.htmlLoader
aus einer HTML-Seite heraus zugreifen.
Wichtig:
Lediglich Seiten, die als Teil einer Anwendung installiert wurden, verfügen über die Eigenschaften
htmlLoader
,
nativeWindow
oder
runtime
und dies nur, wenn sie als Dokument der obersten Ebene geladen wurden. Die Eigenschaften werden nicht hinzugefügt, wenn das Dokument in einen Frame oder iFrame geladen wird. (Ein untergeordnetes Dokument kann auf diese Eigenschaften des übergeordneten Dokuments zugreifen, vorausgesetzt, es befindet sich in derselben Sicherheits-Sandbox. Ein Dokument, das in einen Frame geladen wurde, kann zum Beispiel mit
parent.runtime
auf die Eigenschaft
runtime
des übergeordneten Dokuments zugreifen
.)
