Verwendung der ActionScript-Beispiele

Beispiele mit Codefragmenten

Ein Codefragment-Beispiel sieht folgendermaßen aus:

var x:int = 5; 
trace(x); // 5

Codefragmente enthalten gerade genug Code, um ein einzelnes Konzept zu veranschaulichen. Sie enthalten normalerweise keine Paket- oder Klassenanweisungen.

Klassenbasierte Beispiele

Viele Beispiele zeigen den Quellcode für eine ganze ActionScript-Klasse. Ein klassenbasiertes Beispiel sieht folgendermaßen aus:

package { 
    public class Example1 { 
        public function Example1():void { 
            var x:int = 5; 
            trace(x); //5 
        } 
    } 
}

Der Code eines klassenbasierten Beispiels umfasst eine Paketanweisung, eine Klassendeklaration und eine Konstruktorfunktion.

Praktische Beispiele, die mehrere Quelldateien enthalten

Zahlreiche Themen im ActionScript 3.0 Entwicklerhandbuch werden mit praktischen Beispielen abgeschlossen, die zeigen, wie bestimmte ActionScript-Funktionen in der Praxis verwendet werden. Diese Beispiele umfassen meist mehrere Dateien, wie zum Beispiel:

Praktische Beispiele werden normalerweise in Form von ZIP-Archivdateien bereitgestellt.

Liste der Beispiele für Entwickler in der ZIP-Datei

Die ZIP-Datei für Flash Professional CS5 und Flex 4 (Download von www.adobe.com/go/learn_programmingAS3samples_flash_de ) enthält die folgenden Beispiele:

• AlarmClock ( Beispiel für die Ereignisverarbeitung: Alarm Clock )

• AlgorithmicVisualGenerator ( Beispiel für die Zeichnungs-API: Algorithmic Visual Generator )

• ASCIIArt ( Strings-Beispiel: ASCII-Grafik )

• CapabilitiesExplorer ( Capabilities-Beispiel: Ermitteln von Systemeigenschaften )

• CustomErrors ( Beispiel für die Fehlerverarbeitung: CustomErrors-Anwendung )

• DisplayObjectTransformer ( Geometrie-Beispiel: Anwenden einer Matrixtransformation auf ein Anzeigeobjekt )

• FilterWorkbench ( Beispiel für das Filtern von Anzeigeobjekten: Filter Workbench )

• GlobalStockTicker ( Beispiel: Internationalisierung einer Börsenticker-Anwendung )

• IntrovertIM_HTML ( Beispiel für externe API: Kommunikation zwischen ActionScript und JavaScript in einem Webbrowser )

• NewsLayout ( TextField-Beispiel: Textformatierung im Zeitungsstil )

• PlayList ( Arrays-Beispiel: PlayList )

• PodcastPlayer ( Sound-Beispiel: Podcast-Player )

• ProjectionDragger ( Beispiel: Perspektivische Projektion )

• ReorderByZ ( Verwenden von 3DMatrix-Objekten zur Neuanordnung der Anzeige )

• RSSViewer ( Beispiel für XML in ActionScript: Laden von RSS-Daten aus dem Internet )

• RuntimeAssetsExplorer ( Movieclip-Beispiel: RuntimeAssetsExplorer )

• SimpleClock ( Beispiel für Datum und Uhrzeit: Einfache Analoguhr )

• SpinningMoon ( Bitmap-Beispiel: Animated Spinning Moon

• SpriteArranger ( Beispiel für ein Anzeigeobjekt: SpriteArranger )

• TelnetSocket ( TCP-Socket-Beispiel: Erstellen eines Telnet-Clients )

• VideoJukebox ( Video-Beispiel: Video Jukebox )

• WikiEditor ( Beispiel für reguläre Ausdrücke: Wiki-Parser )

• WordSearch ( Beispiel für Mauseingabe: WordSearch )

Praktische Beispiele sind auch in vielen Kurzanleitungen im Flash Developer Center und im Flex Developer Center enthalten.

Ausführen eines Codefragment-Beispiels in Flash Professional

So führen Sie ein Codefragment-Beispiel in Flash Professional aus:

1. Wählen Sie „Datei“ > „Neu“.

2. Wählen Sie im Dialogfeld „Neues Dokument“ die Option „Flash-Dokument“ aus und klicken Sie dann auf „OK“.

   Ein neues Flash-Fenster wird angezeigt.

3. Klicken Sie im Bedienfeld „Zeitleiste“ auf das erste Bild auf der ersten Ebene.

4. Geben oder fügen Sie im Bedienfeld „Aktionen“ das Codefragment-Beispiel ein.

5. Wählen Sie „Datei“ > „Speichern“. Benennen Sie die Datei und klicken Sie auf „OK“.

6. Wählen Sie „Steuerung“ > „Film testen“ aus, um das Beispiel zu testen.

Ausführen eines klassenbasierten Beispiels in Flash Professional

So führen Sie ein klassenbasiertes Beispiel in Flash Professional aus:

Ausführen eines praktischen Beispiels in Flash Professional

Praktische Beispiele werden normalerweise in Form von ZIP-Archivdateien bereitgestellt. So führen Sie ein praktisches Beispiel in Flash Professional aus:

1. Dekomprimieren Sie die Archivdatei in einem Ordner Ihrer Wahl.

2. Wählen Sie in Flash Professional „Datei“ > „Öffnen“ aus.

3. Wechseln Sie zu dem Ordner, in den Sie die Archivdatei dekomprimiert haben. Wählen Sie die FLA-Datei in diesem Ordner aus und klicken Sie auf „Öffnen“.

4. Wählen Sie „Steuerung“ > „Film testen“ aus, um das Beispiel zu testen.

Ausführen eines Codefragment-Beispiels in Flash Builder

So führen Sie ein Codefragment-Beispiel in Flash Builder aus:

Ausführen eines klassenbasierten Beispiels in Flash Builder

So führen Sie ein klassenbasiertes Beispiel in Flash Builder aus:

1. Wählen Sie „Datei“ > „Neu“ > „ActionScript-Projekt“.

2. Geben Sie den Namen der Primärklasse (wie beispielsweise ContextMenuExample) in das Feld „Projektname“ ein. Verwenden Sie die Standardwerte für die anderen Felder (oder ändern Sie sie je nach Ihrer Umgebung). Klicken Sie auf „Fertig stellen“, um das Projekt und die ActionScript-Hauptdatei zu erstellen.

3. Löschen Sie eventuell generierten Inhalt aus der ActionScript-Datei. Fügen Sie den Beispielcode, einschließlich Paket- und Import-Anweisungen, in die ActionScript-Datei ein und speichern Sie die Datei.

   Hinweis: Einige der klassenbasierten Beispiele, wie das flashx.textLayout.container.ContainerController-Klassenbeispiel , enthalten mehrere Ebenen in der Paketdeklaration ( package flashx.textLayout.container.examples { ). Speichern Sie bei diesen Beispielen die Datei in einem Unterordner, der der Paketdeklaration entspricht (flashx/textLayout/container/examples), oder entfernen Sie den Paketnamen (sodass der ActionScript-Code nur mit package { beginnt); Sie können die Datei dann von jedem Ort aus testen.

4. Zum Ausführen des Beispiels wählen Sie „Ausführen“ > „Ausführen“ für den ActionScript-Hauptklassennamen (z. B. „Ausführen“ > „Ausführen ContextMenuExample“).

Ausführen eines praktischen Beispiels in Flash Builder

Praktische Beispiele werden normalerweise in Form von ZIP-Archivdateien bereitgestellt. So führen Sie ein praktisches Beispiel in Flash Builder aus:

Bühnengröße

Beim Ausführen eines Beispiels auf einem Mobilgerät wird eine wesentlich kleinere Bühne verwendet als bei einem anderen Gerät. Für viele Beispiele ist keine bestimmte Bühnengröße erforderlich. Geben Sie bei der Erstellung der SWF-Datei eine für das Mobilgerät geeignete Bühnengröße an, wie zum Beispiel 176 x 208 Pixel.

Mit den praktischen Beispielen im ActionScript 3.0 Entwicklerhandbuch sollen verschiedene Konzepte und Klassen von ActionScript 3.0 veranschaulicht werden. Die entsprechenden Benutzeroberflächen wurden so konzipiert, dass sie auf Desktopcomputern und Laptops ansprechend aussehen und gut funktionieren. Obwohl die Beispiele auf Mobilgeräten funktionieren, sind Bühnengröße und Design der Benutzeroberfläche nicht für den kleinen Bildschirm geeignet. Sie sollten die praktischen Beispiele auf einem Computer ausführen, um ActionScript zu erlernen, und dann die zugehörigen Codefragmente in den Mobilanwendungen ausführen.

Textfelder anstelle von trace-Anweisungen

Beim Ausführen eines Beispiels auf einem Mobilgerät können Sie die Ausgabe der trace-Anweisungen des Beispiels nicht sehen. Um die Ausgabe zu sehen, erstellen Sie eine Instanz der TextField-Klasse. Fügen Sie dann den Text der trace-Anweisungen an die text -Eigenschaft des Textfeldes an.

Zum Einrichten eines Textfeldes für die trace-Ausgabe können Sie die folgende Funktion verwenden:

function createTracingTextField(x:Number, y:Number, 
                                width:Number, height:Number):TextField { 
           
    var tracingTF:TextField = new TextField(); 
    tracingTF.x = x; 
    tracingTF.y = y; 
    tracingTF.width = width; 
    tracingTF.height = height; 
     
    // A border lets you more easily see the area the text field covers. 
    tracingTF.border = true; 
    // Left justifying means that the right side of the text field is automatically 
    // resized if a line of text is wider than the width of the text field. 
    // The bottom is also automatically resized if the number of lines of text 
    // exceed the length of the text field. 
    tracingTF.autoSize = TextFieldAutoSize.LEFT; 
     
    // Use a text size that works well on the device. 
    var myFormat:TextFormat = new TextFormat(); 
    myFormat.size = 18; 
    tracingTF.defaultTextFormat = myFormat; 
     
    addChild(tracingTF); 
    return tracingTF; 
}

Fügen Sie diese Funktion beispielsweise der Dokumentklasse als private Funktion hinzu. Dann können Sie in anderen Methoden der Dokumentklasse den folgenden Code verwenden, um Daten zu verfolgen.

var traceField:TextField = createTracingTextField(10, 10, 150, 150); 
// Use the newline character "\n" to force the text to the next line. 
traceField.appendText("data to trace\n"); 
traceField.appendText("more data to trace\n"); 
// Use the following line to clear the text field. 
traceField.appendText("");

Die appendText() -Methode akzeptiert nur einen Wert als Parameter. Bei diesem Wert handelt es sich um einen String (eine String-Instanz oder ein String-Literal). Zum Ausgeben des Wertes einer Variablen, die keinen String-Wert enthält, müssen Sie den Wert zuerst in einen String umwandeln. Dies können Sie am einfachsten mit einem Aufruf der toString() -Methode des jeweiligen Objekts verwirklichen:

var albumYear:int = 1999; 
traceField.appendText("albumYear = "); 
traceField.appendText(albumYear.toString());

Textgröße

Viele Beispiele verwenden Textfelder, damit ein Konzept besser veranschaulicht werden kann. Manchmal lässt sich der Text auf einem Mobilgerät besser lesen, wenn die Größe des Textes im Textfeld angepasst wird. Wenn ein Beispiel eine TextField-Instanz namens myTextField enthält, können Sie die Textgröße mit dem folgenden Code ändern:

// Use a text size that works well on the device. 
var myFormat:TextFormat = new TextFormat(); 
myFormat.size = 18; 
myTextField.defaultTextFormat = myFormat

Erfassen von Benutzereingaben

Das Betriebssystem und der Browser des Mobilgeräts erfassen einige Benutzereingabe-Ereignisse, die der SWF-Inhalt nicht erhält. Das konkrete Verhalten richtet sich nach dem Betriebssystem und dem Browser; es kann jedoch ein unerwartetes Verhalten auftreten, wenn die Beispiele auf einem Mobilgerät ausgeführt werden. Weitere Informationen finden Sie unter KeyboardEvent-Reihenfolge .

Die Benutzeroberflächen zahlreicher Beispiele sind für Desktopcomputer oder Laptops ausgelegt. So eignen sich beispielsweise die meisten praktischen Beispiele im ActionScript 3.0 Entwicklerhandbuch besonders gut für die Anzeige auf einem Desktop. Deshalb kann die Bühne auf dem Bildschirm eines Mobilgeräts nicht immer vollständig angezeigt werden. Ob die Möglichkeit besteht, den Inhalt im Browser zu durchblättern (zu schwenken), richtet sich nach dem Browser. Die Beispiele sind auch nicht dafür ausgelegt, Ereignisse in Bezug auf das Blättern oder den Bildlauf zu erfassen und zu verarbeiten. Deshalb sind die Benutzeroberflächen einiger Beispiele nicht für die Ausführung auf einem kleinen Bildschirm geeignet. Sie sollten die Beispiele auf einem Computer ausführen, um ActionScript zu erlernen, und dann die zugehörigen Codefragmente in den Mobilanwendungen ausführen.

Weitere Informationen finden Sie unter Schwenken und Scrollen von Anzeigeobjekten .

Steuern des Fokus

Bei manchen Beispielen müssen Sie den Fokus auf ein Feld richten. Dies bietet Ihnen die Möglichkeit, Text einzugeben oder eine Schaltfläche auszuwählen. Um den Fokus auf ein bestimmtes Feld zu richten, verwenden Sie das Zeigegerät des Mobilgeräts oder Ihren Finger. Sie können auch die Navigationstasten des Mobilgeräts verwenden, um den Fokus auf ein Feld zu richten. Um eine Schaltfläche auszuwählen, die derzeit den Fokus hat, verwenden Sie die Auswahltaste des Mobilgeräts, ähnlich wie die Eingabetaste auf einem Computer. Bei manchen Geräten müssen Sie zweimal auf eine Schaltfläche tippen, um sie auszuwählen.

Weitere Informationen zum Fokus finden Sie unter Fokusverwaltung .

Steuern von Mausereignissen

Zahlreiche Beispiele warten auf Mausereignisse. Auf einem Computer treten Mausereignisse beispielsweise auf, wenn Sie die Maus über ein Anzeigeobjekt bewegen oder auf ein Anzeigeobjekt klicken. Auf Mobilgeräten werden Ereignisse, die über Zeigegeräte oder mit dem Finger ausgelöst werden, als Berührungsereignisse bezeichnet. Flash Player 10.1 ordnet Berührungsereignisse den Mausereignissen zu. Durch diese Zuordnung wird gewährleistet, dass SWF-Inhalt, der vor Flash Player 10.1 entwickelt wurde, auch weiterhin funktioniert. Deswegen funktionieren die Beispiele, wenn Sie ein Anzeigeobjekt mithilfe eines Zeigegeräts auswählen oder ziehen.

Leistung

Mobilgeräte verfügen über weniger Prozessorleistung als Desktopgeräte. Deshalb werden Beispiele, die die CPU stark beanspruchen, auf Mobilgeräten möglicherweise langsamer ausgeführt. So ist für das Beispiel für die Zeichnungs-API: Algorithmic Visual Generator bei jedem Bild ein hoher Berechnungs- und Zeichenaufwand erforderlich. Bei Ausführung dieses Beispiels auf einem Computer werden verschiedene Zeichnungs-APIs vorgestellt. Wegen der eingeschränkten Leistung ist das Beispiel jedoch nicht für alle Mobilgeräte geeignet.

Weitere Informationen zur Leistung auf Mobilgeräten finden Sie unter Leistungsoptimierung für die Flash-Plattform .

Empfohlene Verfahren

Die Beispiele berücksichtigen keine empfohlenen Verfahren für die Entwicklung von Anwendungen für Mobilgeräte. Der eingeschränkten Speicher- und Leistungskapazität von Mobilgeräten muss besondere Beachtung eingeräumt werden. Gleichermaßen gelten hinsichtlich der Benutzeroberfläche für einen kleinen Bildschirm andere Anforderungen als für die Anzeige auf einem Desktop. Weitere Informationen zur Entwicklung von Anwendungen für Mobilgeräte finden Sie unter Leistungsoptimierung für die Flash-Plattform .