Funktionen sind wie Maschinen, die immer wiederkehrende Aufgaben automatisch abarbeiten. Und einige Funktionen erfordern sogar noch Parameter, welche die Produktion beeinflussen. Das ist wie mit einer Brotbackmaschine, die für das Erstellen eines Brotes eine ganze Reihe von Zutaten benötigt und am Ende ein fertiges Brot herausgibt. Aber nicht alle Funktionen müssen einen Wert als Ergebnis zurückgeben, meist machen sie aber Gebrauch von dieser Möglichkeit. Beispiele dafür sind die vergangenen Millisekunden seit Start der Anwendung getTimer() und die Versionsnummer des Flash Players:
Sollte eine Funktion nicht allgemein zur Verfügung stehen, sondern zu einem Objekt gehören, dann spricht man von einer Methode. Diese Unterscheidung entspricht dem Unterschied zwischen Variablen und den zu einem Objekt gehörenden Eigenschaften (siehe Seite 363):
Flash bietet viele bereits vordefinierte Methoden und Funktionen, von denen Sie einige schon im Kapitel «Anweisungen und Aktionen« kennen gelernt haben. Denn die dort eingeführten Aktionen zählen ebenfalls zu den Funktionen. Und da diese Funktionen alle global zur Verfügung stehen, spricht man auch von Toplevel-Funktionen.
Die bereits in Flash enthaltenen globalen Funktionen hat Macromedia im globalen Objekt abgelegt. Somit kann man auch bei diesen Toplevel-Funktionen von Methoden sprechen. Um genau zu sein, handelt es sich um Methoden des globalen Objektes.
Macromedia hat die meisten Funktionen zur besseren Übersicht innerhalb des ActionScript-Editors unter Globale Funktionen in die folgenden Kategorien unterteilt:
Einige wichtige Funktionen aus diesen Kategorien sind bereits in den zurückliegenden Kapiteln beschrieben worden. Und weitere wichtige Funktionen finden Sie im Folgenden zusammengefasst. Deshalb sind hier nur die Signaturen der am häufigsten benötigten Funktionen zum schnellen Nachschlagen angegeben.
Die Signaturen beschreiben, mit welchen Parametern eine Funktion aufgerufen werden darf und welches Ergebnis sie zurückliefert. Durch einen Doppelpunkt getrennt ist dabei jeweils der Typ der Parameter bzw. der Rückgabe angegeben, wobei Void bedeutet, dass eine Funktion kein Ergebnis (bzw. undefined) liefert. Einige Typangaben sind aus Kompatibilitätsgründen auch weiter gefasst als notwendig, indem entweder gar keinen Typ angeben oder der sehr allgemein gehaltene Typ Object verwendet wird.
Leider haben sich die Signaturen von Version zu Version geändert. Mit den hier in der Version 7.2 von Flash ermittelten Signaturen gehen Sie aber auf Nummer sicher, da diese meist auch in älteren Flash-Versionen funktionieren.
Tabelle 9.1
Toplevel-Funktionen in Flash MX 2004 (Stand Version 7.2)
Signatur
|
Beschreibung
|
Bemerkung
|
call(bild:Object):Void;
|
Ruft den ActionScript-Code in einem Bild auf.
|
Der Parameter bild kann sowohl eine Bildbezeichnung (String) oder eine Bildnummer (Number) sein. Die Verwendung wird nicht mehr empfohlen.
|
clearInterval(id:Number):Void;
|
Löscht ein Intervall, das zur zeitabhängigen Ausführung von Code definiert wurde.
|
Siehe Kapitel 12, »Ereignisse«
|
duplicateMovieClip(movieclip:String, neuerName:String, tiefe:Number):Void;
|
Aktion zum Duplizieren eines Movieclips.
|
Siehe Kapitel 6, »Aktionen«
|
escape(wert:String):String;
|
Konvertiert eine Zeichenkette in die URL-Schreibweise (Sonderzeichen werden durch eine hexadezimale Zahl mit führendem Prozentzeichen dargestellt).
|
|
eval(ausdruck:String):Object;
|
Aktion zum Ermitteln eines Objektes abhängig von dem Objektnamen.
|
Siehe Kapitel 7, »Variablen«
|
fscommand(kommando:String, parameter:String):Void;
|
Aktion zum Senden von Nachrichten an den Flash Player bzw. eine Host-Anwendung.
|
Siehe Kapitel 6, »Aktionen«
|
getProperty(movieclip:Object, eigenschaft:Object):Object;
|
Ermittelt den Wert einer Eigenschaft eines Movieclips.
|
Siehe Kapitel 15.1, »Eigenschaften«
|
getTimer():Number;
|
Ermittelt die Zeit seit dem Start des Flash Players in Millisekunden.
|
|
getURL(url:String, fensterOderFrame:String, postOderGetMethode:String):Void;
|
Ruft die angegebene URL auf.
|
Siehe Kapitel 6, »Aktionen«
|
getVersion():String;
|
Ermittelt die Version und das Betriebssystem des Flash Players.
|
|
gotoAndPlay(szeneOderBild:Object, bild:Object):Void;
|
Verzweigt zu einem anderen Bild in der Zeitleiste.
|
Die Parameter können unterschiedliche Typen haben. Siehe Kapitel 6, »Aktionen«.
|
gotoAndStop():Void;
|
Verzweigt zu einem anderen Bild in der Zeitleiste.
|
Die Parameter können unterschiedliche Typen haben. Macromedia hat hier leider keine vollständige Signatur in der Form gotoAndStop(szeneOderBild:Object, bild:Object):Void; angegeben. Siehe Kapitel 6, »Aktionen«.
|
Signatur
|
Beschreibung
|
Bemerkung
|
int(zahl:Number):Number;
|
Konvertiert eine Zahl in eine Ganzzahl.
|
Die Verwendung wird nicht mehr empfohlen.
|
isFinite(value:Object):Boolean;
|
Überprüft, ob eine Zahl endlich ist.
|
Siehe Kapitel 7, »Werte«
|
isNaN(value:Object):Boolean;
|
Überprüft, ob ein Wert keine Zahl (NaN für »not a number«) ist.
|
Siehe Kapitel 7, »Werte«
|
loadMovie(url:String, movieclip:Object, postOderGetMethode:String):Void;
|
Lädt eine SWF- oder JPEG-Datei in einen Movieclip.
|
Siehe Kapitel 6, »Aktionen«
|
loadMovieNum(url:String, stufe:Number, postOderGetMethode:String):Void;
|
Lädt eine SWF- oder JPEG-Datei in eine Stufe (engl. Level).
|
Siehe Kapitel 6, »Aktionen«
|
loadVariables(url:String, movieclip:Object, postOderGetMethode:String):Void;
|
Lädt Variablen in einen Movieclip.
|
Siehe Kapitel 6, »Aktionen«
|
loadVariablesNum(url:String, stufe:Number, postOderGetMethode:String):Void;
|
Lädt Variablen in eine Stufe (engl. Level).
|
Siehe Kapitel 6, »Aktionen«
|
nextFrame():Void;
|
Wechselt in das nächste Bild.
|
Siehe Kapitel 6, »Aktionen«
|
nextScene():Void;
|
Wechselt in die nächste Szene.
|
Siehe Kapitel 6, »Aktionen«
|
parseFloat(wert:String):Number;
|
Konvertiert eine Zeichenkette in eine Zahl.
|
Siehe Kapitel 7, »Werte«
|
parseInt(wert:String,basis:Number):Number;
|
Konvertiert eine Zeichenkette in eine Zahl.
|
Siehe Kapitel 7, »Werte«
|
play():Void;
|
Spielt die Zeitleiste ab.
|
Siehe Kapitel 6, »Aktionen«
|
prevFrame():Void;
|
Wechselt in das vorhergehende Bild.
|
Siehe Kapitel 6, »Aktionen«
|
prevScene():Void;
|
Wechselt in die vorher-gehende Szene.
|
Siehe Kapitel 6, »Aktionen«
|
print(movieclip:Object, begrenzungsrechteck:String):Void;
|
Druckt das angegebene Ziel.
|
Siehe Kapitel 6, »Aktionen«
|
printAsBitmap(movieclip:Object, begrenzungsrechteck:String):Void;
|
Druckt das angegebene Ziel.
|
Siehe Kapitel 6, »Aktionen«
|
printAsBitmapNum(stufe:Number, begrenzungsrechteck:String):Void;
|
Druckt das angegebene Ziel.
|
Siehe Kapitel 6, »Aktionen«
|
printNum(stufe:Number, begrenzungsrechteck:String):Void;
|
Druckt das angegebene Ziel.
|
Siehe Kapitel 6, »Aktionen«
|
random(zahl:Number):Number;
|
Berechnet eine Zufallszahl.
|
Die Verwendung wird nicht mehr empfohlen.
|
removeMovieClip(movieclip:Object):Void;
|
Entfernt einen Movieclip.
|
Siehe Kapitel 6, »Aktionen«
|
setInterval():Number;
|
Definiert ein Intervall, das zur zeitabhängigen Ausführung von Code definiert wurde.
|
Macromedia hat hier keine vollständige Signatur angegeben. Siehe Kapitel 12, »Ereignisse«.
|
Signatur
|
Beschreibung
|
Bemerkung
|
setProperty(movieclip:Object, eigenschaft:Object, wert:Object):Void;
|
Setzt eine Eigenschaft eines Movieclips.
|
Siehe Kapitel 15.1, »Eigenschaften«
|
startDrag(movieclip:Object, zentriere:Boolean, links:Number, oben:Number, rechts:Number, unten:Number):Void;
|
Hängt einen Movieclip an den Mauszeiger.
|
Siehe Kapitel 6, »Aktionen«
|
stop():Void;
|
Stoppt das Abspielen der Zeitleiste.
|
Siehe Kapitel »Aktionen«.
|
stopAllSounds():Void;
|
Stoppt alle Sounds.
|
Siehe Kapitel 6, »Aktionen«
|
stopDrag():Void;
|
Löst den gerade am Mauszeiger gebundenen Movieclip.
|
Siehe Kapitel 6, »Aktionen«
|
targetPath(movieclip:MovieClip):String;
|
Ermittelt den Pfad zu einem Movieclip in der Punktschreibweise.
|
Siehe Kapitel 11, »DOM«
|
toggleHighQuality():Void;
|
Aktion zum Wechsel der Darstellungsqualität.
|
Die Verwendung wird nicht mehr empfohlen. Siehe
Kapitel 6, »Aktionen«.
|
trace(wert:String):Void;
|
Gibt wert als Zeichenkette im Ausgabefenster aus.
|
|
unescape(wert:String):String;
|
Konvertiert eine Zeichenkette aus der URL-Schreibweise in die »normale« Darstellung.
|
|
unloadMovie(movieclip):Void;
|
Löscht den Inhalt eines Movieclips.
|
Siehe Kapitel 6, »Aktionen«
|
unloadMovieNum(stufe:Number):Void;
|
Löscht den Inhalt einer Stufe (engl. Level).
|
Siehe Kapitel 6, »Aktionen«
|
updateAfterEvent():Void;
|
Aktualisiert die Darstellung auf dem Bildschirm.
|
Siehe Kapitel 6, »Ereignisse«
|
MMExecute(ausdruck:String);
|
Erlaubt das Aufrufen von Flash JavaScripts innerhalb der Flash-Entwicklungsumgebung.
|
Siehe Kapitel 4.4, »Anpassen«
|