Arbeiten mit der UILoader-Komponente

Die UILoader-Komponente (UI-Ladeobjekt) ist ein Container, der SWF-, JPEG-, progressive JPEG-, PNG- und GIF-Dateien anzeigen kann. Sie können ein UI-Ladeobjekt immer dann verwenden, wenn Sie Inhalt von einem entfernten Speicherort abrufen und in eine Flash-Anwendung übertragen müssen. Beispielsweise können Sie mit einem UI-Ladeobjekt ein Firmenlogo (JPEG-Datei) in ein Formular einfügen. Sie könnten eine UILoader-Komponente etwa in einer Anwendung verwenden, in der Fotos angezeigt werden. Sie verwenden die Methode load() , um den Inhalt zu laden, die Eigenschaft percentLoaded , um festzustellen, welcher Anteil des Inhalts jeweils geladen ist, und das Ereignis complete , um festzustellen, wann der Ladevorgang abgeschlossen ist.

Um die Größe des Inhalts anzupassen, können Sie entweder den Inhalt skalieren oder die Größe der UILoader-Instanz ändern. Standardmäßig wird der Inhalt so skaliert, dass er in das UILoader-Objekt passt. Sie können den Inhalt auch zur Laufzeit laden und den Ladevorgang überwachen (obwohl der Inhalt nach dem Laden zwischengespeichert wird, sodass der Fortschritt schnell auf 100% springt). Wenn Sie beim Laden von Inhalt in das UILoader-Objekt eine Position angeben, müssen Sie die X- und X-Koordination als 0,0 angeben.

Benutzerinteraktion mit der UILoader-Komponente

Eine UILoader-Komponente kann nicht den Fokus erhalten. Jedoch kann der Inhalt, der in der UILoader-Komponente geladen ist, den Fokus annehmen und mit ihm interagieren. Weitere Informationen zum Steuern des Fokus finden Sie im Abschnitt zur FocusManager-Klasse im ActionScript 3.0 Referenzhandbuch für Flash Professional und unter Arbeiten mit dem FocusManager .

Parameter der UILoader-Komponente

Die folgenden Authoring-Parameter können für jede Instanz einer UILoader-Komponente im Eigenschaften- oder Komponenteninspektor festgelegt werden: autoLoad , maintainAspectRatio , source und scaleContent . Jeder dieser Parameter besitzt eine entsprechende ActionScript-Eigenschaft desselben Namens.

Eine Live-Vorschau der einzelnen UILoader-Instanzen spiegelt die Änderungen wieder, die im Eigenschaften- oder Komponenten-Inspektor beim Authoring vorgenommen wurden.

Sie können zusätzliche Optionen für UILoader-Instanzen mit den Methoden, Eigenschaften und Ereignissen von ActionScript festlegen. Weitere Informationen finden Sie im Abschnitt zur UILoader-Klasse im ActionScript 3.0 Referenzhandbuch für Flash Professional .

Erstellen einer Anwendung mit der UILoader-Komponente

In der folgenden Anleitung wird erläutert, wie beim Authoring eine UILoader-Komponente in eine Anwendung eingefügt wird. In dem Beispiel lädt das UI-Ladeobjekt ein GIF-Bild eines Logos.

  1. Erstellen Sie ein neues Flash-Dokument (ActionScript 3.0).

  2. Ziehen Sie die UILoader-Komponente aus dem Bedienfeld „Komponenten“ auf die Bühne.

  3. Geben Sie im Eigenschafteninspektor den Instanznamen aUI ein.

  4. Wählen Sie den Loader auf der Bühne und im Komponenteninspektor aus, und geben Sie http://www.helpexamples.com/images/logo.gif für den Parameter source ein.

Erstellen einer UILoader-Komponenteninstanz mithilfe von ActionScript-Code

In diesem Beispiel wird mithilfe von ActionScript-Code eine UILoader-Komponente erstellt und das JPEG-Bild einer Blume geladen. Wenn das Ereignis complete eintritt, wird die Anzahl der geladenen Bytes im Bedienfeld „Ausgabe“ angezeigt.

  1. Erstellen Sie ein neues Flash-Dokument (ActionScript 3.0).

  2. Ziehen Sie die UILoader-Komponente aus dem Bedienfeld „Komponenten“ in das Bedienfeld „Bibliothek“.

  3. Öffnen Sie das Bedienfeld „Aktionen“, wählen Sie in der Hauptzeitleiste Bild 1 aus und geben Sie den folgenden ActionScript-Code ein: 

    import fl.containers.UILoader; 
 
var aLoader:UILoader = new UILoader(); 
aLoader.source = "http://www.flash-mx.com/images/image1.jpg"; 
aLoader.scaleContent = false; 
addChild(aLoader); 
 
aLoader.addEventListener(Event.COMPLETE, completeHandler); 
function completeHandler(event:Event) { 
    trace("Number of bytes loaded: " + aLoader.bytesLoaded); 
}

  4. Wählen Sie „Steuerung“ > „Film testen“.