Globale Funktionen

Dieser Abschnitt enthält eine Beschreibung einiger integrierter Funktionen, die bei Verwendung von ActionScript in jedem Teil einer SWF-Datei zur Verfügung stehen. Diese globalen Funktionen decken eine ganze Reihe allgemeiner Programmieraufgaben ab, wie etwa die Verwendung von Datentypen (Boolean(), int() usw.), die Erstellung von Debugging-Informationen (trace()) oder die Kommunikation mit Flash Player oder dem Browser (fscommand()).

Übersicht über globale Funktionen

Modifizierer

Syntax

Beschreibung

 

Array([numElements], [elementN]) : Array

Erstellt ein neues leeres Array oder wandelt bestimmte Elemente in ein Array um.

 

Boolean(expression:Object) : Boolean

Wandelt den Parameter expression in einen booleschen Wert um und gibt entweder true oder false zurück.

 

call(frame:Object)

Veraltet seit Flash Player 5. Diese Aktion wurde zugunsten von function aufgegeben.

Führt das Skript im aufgerufenen Bild aus, ohne den Abspielkopf auf dieses Bild zu verschieben.

 

chr(number:Number) : String

Veraltet seit Flash Player 5. Diese Funktion wurde zugunsten von String.fromCharCode() aufgegeben.

Wandelt ASCII-Codenummern in Zeichen um.

 

clearInterval(intervalID:Number)

Bricht ein Intervall ab, das durch einen Aufruf von setInterval() erstellt wurde.

 

duplicateMovieClip(target:Object, newname:String, depth:Number)

Erstellt während der Wiedergabe der SWF-Datei eine Instanz eines Movieclips.

 

escape(expression:String) : String

Wandelt den Parameter in einen String um und kodiert ihn in ein URL-Format, bei dem alle nicht alphanumerischen Zeichen als "%", gefolgt von einer Hexadezimalsequenz dargestellt werden.

 

eval(expression:Object) : Object

Greift anhand des Namens auf Variablen, Eigenschaften, Objekte oder Movieclips zu.

 

fscommand(command:String, parameters:String)

Ermöglicht die Kommunikation einer SWF-Datei mit dem Flash Lite Player oder der Umgebung eines Mobilgeräts (z. B. dem Betriebssystem).

 

fscommand2(command:String, parameters:String)

Ermöglicht die Kommunikation der SWF-Datei mit dem Flash Lite Player oder einer Hostanwendung auf einem Mobilgerät.

 

getProperty(my_mc:Object, property:Object) : Object

Veraltet seit Flash Player 5. Diese Funktion wurde zugunsten der seit Flash Player 5 verwendeten Punktsyntax aufgegeben.

Gibt den Wert der angegebenen Eigenschaft für den Movieclip my_mc zurück.

 

getTimer() : Number

Gibt die Anzahl der Millisekunden zurück, die seit dem Beginn der Wiedergabe der SWF-Datei vergangen sind.

 

getURL(url:String, [window:String], [method:String])

Lädt ein Dokument von einer bestimmten URL in ein Fenster oder übergibt Variablen an eine andere Anwendung, die sich unter einer definierten URL befindet.

 

getVersion() : String

Gibt einen String mit Angaben zur Version des Flash Players und zur Plattform zurück.

 

gotoAndPlay([scene:String], frame:Object)

Verschiebt den Abspielkopf zum angegebenen Bild in einer Szene und startet die Wiedergabe ab diesem Bild.

 

gotoAndStop([scene:String], frame:Object)

Verschiebt den Abspielkopf zum angegebenen Bild in einer Szene und hält den Film dort an.

 

ifFrameLoaded([scene:String], frame:Object, statement(s):Object)

Veraltet seit Flash Player 5. Diese Funktion wurde gestrichen. Macromedia empfiehlt die Verwendung der Eigenschaft MovieClip._framesloaded.

Überprüft, ob die Inhalte eines bestimmten Bilds lokal verfügbar sind.

 

int(value:Number) : Number

Veraltet seit Flash Player 5. Diese Funktion wurde zugunsten von Math.round() aufgegeben.

Wandelt eine Dezimalzahl durch Abschneiden des Dezimalwerts in eine Ganzzahl um.

 

isFinite(expression:Object) : Boolean

Berechnet den Wert von expression und gibt true zurück, wenn es sich um eine endliche Zahl handelt, bzw. false, wenn es sich um positive oder negative Unendlichkeit handelt.

 

isNaN(expression:Object) : Boolean

Wertet den Parameter aus und gibt true zurück, wenn der Wert NaN (Not a Number - keine Zahl) lautet.

 

length(expression:String, variable:Object) : Number

Veraltet seit Flash Player 5. Diese Funktion wurde zusammen mit den String-Funktionen gestrichen. Macromedia empfiehlt die Verwendung der Methoden in der String-Klasse und in der Eigenschaft String.length, um die gleichen Schritte auszuführen.

Gibt die Länge des angegebenen Strings oder der angegebenen Variablen zurück.

 

loadMovie(url:String, target:Object, [method:String])

Lädt eine SWF- oder JPEG-Datei in den Flash Player, während die ursprüngliche SWF-Datei wiedergegeben wird.

 

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

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

 

loadVariables(url:String, target:Object, [method:String])

Liest Daten aus einer externen Datei, beispielsweise aus einer Textdatei oder aus Text, der von ColdFusion, einem CGI-, ASP- (Active Server Pages), PHP- oder Perl-Skript generiert wurde, und setzt die Variablenwerte in einen target-Movieclip ein.

 

loadVariablesNum(url:String, level:Number, [method:String])

Liest Daten aus einer externen Datei, beispielsweise aus einer Textdatei oder aus Text, der von ColdFusion, einem CGI-, ASP- (Active Server Pages), PHP- oder Perl-Skript generiert wurde, und setzt die Variablenwerte in eine Flash Player-Stufe ein.

 

mbchr(number:Number)

Veraltet seit Flash Player 5. Diese Funktion wurde zugunsten der Methode String.fromCharCode() aufgegeben.

Wandelt eine ASCII-Codenummer in ein Multibyte-Zeichen um.

 

mblength(string:String) : Number

Veraltet seit Flash Player 5. Diese Funktion wurde zugunsten der Eigenschaft String.length aufgegeben.

Gibt die Länge des Multibyte-Zeichenstrings zurück.

 

mbord(character:String) : Number

Veraltet seit Flash Player 5. Diese Funktion wurde zugunsten der Methode String.charCodeAt() aufgegeben.

Wandelt das angegebene Zeichen in eine Multibyte-Zahl um.

 

mbsubstring(value:String, index:Number, count:Number) : String

Veraltet seit Flash Player 5. Diese Funktion wurde zugunsten der Methode String.substr() aufgegeben.

Extrahiert aus einem Multibyte-Zeichenstring einen neuen Multibyte-Zeichenstring.

 

nextFrame()

Verschiebt den Abspielkopf zum nächsten Bild.

 

nextScene()

Verschiebt den Abspielkopf zu Bild 1 der nächsten Szene.

 

Number(expression:Object) : Number

Wandelt den Parameter expression in eine Zahl um.

 

Object([value:Object]) : Object

Erstellt ein neues leeres Objekt oder wandelt die angegebene Zahl, den angegebenen String oder den angegebenen booleschen Wert in ein Objekt um.

 

on(mouseEvent:Object)

Gibt das Maus- oder Tastenereignis zum Auslösen einer Aktion an.

 

onClipEvent(movieEvent:Object)

Löst Aktionen aus, die für eine bestimmte Instanz eines Movieclips definiert sind.

 

ord(character:String) : Number

Veraltet seit Flash Player 5. Diese Funktion wurde zugunsten der Methoden und Eigenschaften der String-Klasse aufgegeben.

Wandelt Zeichen in ASCII-Codenummern um.

 

parseFloat(string:String) : Number

Wandelt einen String in eine Gleitkommazahl um.

 

parseInt(expression:String, [radix:Number]) : Number

Wandelt einen String in eine Ganzzahl um.

 

play()

Bewegt den Abspielkopf in der Zeitleiste vorwärts.

 

prevFrame()

Verschiebt den Abspielkopf zum vorherigen Bild.

 

prevScene()

Verschiebt den Abspielkopf zu Bild 1 der vorherigen Szene.

 

random(value:Number) : Number

Veraltet seit Flash Player 5. Diese Funktion wurde zugunsten von Math.random() aufgegeben.

Gibt eine nach dem Zufallsprinzip ausgewählte Ganzzahl zwischen 0 und der im Parameter value angegebenen Ganzzahl minus 1 zurück.

 

removeMovieClip(target:Object)

Löscht den angegebenen Movieclip.

 

setInterval(functionName:Object, interval:Number, [param:Object], objectName:Object, methodName:String) : Number

Ruft während der Wiedergabe einer SWF-Datei in regelmäßigen Abständen eine Funktion, eine Methode oder ein Objekt auf.

 

setProperty(target:Object, property:Object, expression:Object)

Ändert den Eigenschaftswert eines Movieclips während der Wiedergabe des Films.

 

startDrag(target:Object, [lock:Boolean], [left,top,right,bottom:Number])

Gibt den im Parameter target angegebenen Movieclip während der Wiedergabe des Films für Ziehoperationen frei.

 

stop()

Stoppt die Wiedergabe der aktuellen SWF-Datei.

 

stopAllSounds()

Stoppt sämtliche Sounds, die derzeit in einer SWF-Datei wiedergegeben werden, ohne jedoch den Abspielkopf anzuhalten.

 

stopDrag()

Beendet den aktuellen Ziehvorgang.

 

String(expression:Object) : String

Gibt den angegebenen Parameter als String zurück.

 

substring(string:String, index:Number, count:Number) : String

Veraltet seit Flash Player 5. Diese Funktion wurde zugunsten von String.substr() aufgegeben.

Extrahiert einen Teil eines Strings.

 

targetPath(targetObject:Object) : String

Gibt einen String mit dem Zielpfad für movieClipObject zurück.

 

tellTarget(target:String, statement(s):Object)

Veraltet seit Flash Player 5. Macromedia empfiehlt die Verwendung der Punktnotation (.) und der Anweisung with.

Führt die im Parameter statements angegebenen Anweisungen für die im Parameter target angegebene Zeitleiste aus.

 

toggleHighQuality()

Veraltet seit Flash Player 5. Diese Funktion wurde zugunsten von _quality aufgegeben.

Aktiviert bzw. deaktiviert das Anti-Aliasing in Flash Player.

 

trace(expression:Object)

Wertet den Ausdruck aus und gibt das Ergebnis aus.

 

unescape(string:String) : String

Wertet den Parameter x als String aus, dekodiert den String aus dem URL-Format (indem er alle Hexadezimalsequenzen in ASCII-Zeichen umwandelt) und gibt den String zurück.

 

unloadMovie(target)

Entfernt einen Movieclip, der mithilfe von loadMovie() in Flash Player geladen wurde.

 

unloadMovieNum(level:Number)

Entfernt eine SWF- oder Bilddatei aus Flash Player, die mithilfe von loadMovieNum() geladen wurde.