loadMovieNum-Funktion

loadMovieNum(url:String, level:Number [, method:String]) : Void

Lädt eine SWF- oder JPEG-Datei in eine Stufe im Flash Player, während die ursprünglich geladene SWF-Datei wiedergegeben wird.

Tipp: Verwenden Sie MovieClipLoader.loadClip() anstelle dieser Funktion, wenn Sie den Download-Fortschritt überwachen möchten.

Normalerweise zeigt der Flash Player nur einen einzelnen Film (SWF-Datei) an und wird dann geschlossen. Mit der loadMovieNum()-Aktion können Sie mehrere SWF-Dateien gleichzeitig wiedergeben oder zwischen diesen wechseln, ohne ein weiteres HTML-Dokument laden zu müssen.

Wenn Sie anstelle einer Stufe ein Ziel angeben möchten, verwenden Sie loadMovie() anstelle von loadMovieNum().

Die Stapelanordnung im Flash Player beginnt mit Stufe 0. Stufen sind vergleichbar mit Overhead-Folien. Sie sind durchsichtig bis auf die Objekte, die sich auf den einzelnen Stufen befinden. Bei Verwendung der Funktion loadMovieNum() müssen Sie eine Flash Player-Stufe angeben, in die die SWF-Datei geladen werden soll. Wenn eine SWF-Datei in eine Stufe geladen wird, können Sie mit der Syntax _levelN (wobei N die Nummer der gewünschten Stufe ist) das Ziel für die SWF-Datei angeben.

Beim Laden einer SWF-Datei können Sie eine beliebige Stufe angeben, auch eine Stufe, in die bereits eine SWF-Datei geladen ist. In diesem Fall wird die vorhandene SWF-Datei durch die neue ersetzt. Wenn Sie eine neue SWF-Datei in Stufe 0 laden, werden alle Stufen im Flash Player entladen, und Stufe 0 wird durch die neue Datei ersetzt. Die SWF-Datei in Stufe 0 legt die Bildrate, die Hintergrundfarbe und die Bildgröße aller anderen geladenen SWF-Dateien fest.

Sie können die Funktion loadMovieNum() auch verwenden, um JPEG-Dateien in eine SWF-Datei zu laden, die gerade wiedergegeben wird. Sowohl bei Grafiken als auch bei SWF-Dateien wird die linke obere Ecke beim Laden des Films an der linken oberen Ecke der Bühne ausgerichtet. In beiden Fällen übernimmt die geladene Datei die Dreh- und Skalierungseigenschaften des ursprünglichen Films, und der ursprüngliche Inhalt der angegebenen Stufe wird überschrieben.

Hinweis: Im progressiven Format gespeicherte JPEG-Dateien werden nicht unterstützt.

Mit unloadMovieNum() entfernen Sie SWF-Dateien oder Bilder, die mit loadMovieNum() geladen wurden.

Verfügbarkeit: ActionScript 1.0, Flash Lite 1.1. Flash 4-Dateien, die in Flash ab Version 5 geöffnet werden, werden in die korrekte Syntax umgewandelt. JPEG-Dateien können erst ab Flash Player 6 geladen werden.

Parameter

url:String - Die absolute oder relative URL für die zu ladende SWF- oder JPEG-Datei. Ein relativer Pfad muss relativ zur SWF-Datei in Stufe 0 sein. Um SWF-Dateien im eigenständigen Flash Player verwenden oder in der Flash-Authoring-Anwendung im Testmodus testen zu können, müssen diese im selben Ordner gespeichert sein. Die Dateinamen können außerdem keine Laufwerks- und Ordnerbezeichnungen enthalten.

level:Number - Eine Ganzzahl, die die Stufe im Flash Player angibt, in die die SWF-Datei geladen werden soll.

method:String [optional] - Legt eine HTTP-Methode zum Senden von Variablen fest. Dieser Parameter muss den String GET oder POST enthalten. Lassen Sie diesen Parameter weg, wenn es keine zu sendenden Variablen gibt. Bei der Methode GET werden die Variablen am Ende der URL angehängt. Diese Methode wird zum Senden einer kleineren Anzahl von Variablen verwendet. Bei der Methode POST, die zum Senden langer Variablenstrings verwendet wird, werden die Variablen in einem separaten HTTP-Header gesendet.

Beispiel

Im folgenden Beispiel wird die JPEG-Grafik tim.jpg in die Stufe 2 des Flash Players geladen:

loadMovieNum("http://www.helpexamples.com/flash/images/image1.jpg", 2);

Siehe auch

unloadMovieNum-Funktion, loadMovie-Funktion, loadClip (MovieClipLoader.loadClip-Methode), _level-Eigenschaft