| Funktion | Definiert von | ||
|---|---|---|---|
|
Bricht den angegebenen setInterval()-Aufruf ab.
| flash.utils | ||
|
Bricht den angegebenen setTimeout()-Aufruf ab.
| flash.utils | ||
|
Erstellt ein XML-Objekt, das das als Parameter der Methode angegebene ActionScript-Objekt beschreibt.
| flash.utils | ||
|
Gibt in Abhängigkeit vom Wert "System.useCodePage" eine entweder als UTF-8 oder in der System-Codepage codierte, mit Escape-Sequenzen versehene Kopie des Eingabestrings zurück.
| flash.utils | ||
|
Gibt einen Verweis auf das Klassenobjekt der im Parameter "name" angegebenen Klasse zurück.
| flash.utils | ||
|
Gibt den vollständig qualifizierten Klassennamen eines Objekts zurück.
| flash.utils | ||
|
Gibt den vollständig qualifizierten Klassennamen der Basisklasse des im Parameter "value" angegebenen Objekts zurück.
| flash.utils | ||
|
Gibt die Anzahl der Millisekunden zurück, die seit dem Initialisieren von Flash Player vergangen sind, und wird zum Berechnen von Zeitdifferenzen verwendet.
| flash.utils | ||
|
Führt eine Funktion in bestimmten Intervallen aus (Angabe in Millisekunden).
| flash.utils | ||
|
Führt eine bestimmte Funktion nach der angegebenen Verzögerung aus (Angabe in Millisekunden).
| flash.utils | ||
|
Gibt in Abhängigkeit vom Wert "System.useCodePage" eine entweder aus UTF-8 oder aus der System-Codepage decodierte Kopie des Eingabestrings ohne Escape-Sequenzen zurück.
| flash.utils | ||
| clearInterval | () | Funktion |
public function clearInterval(id:uint):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Bricht den angegebenen setInterval()-Aufruf ab.
Parameter
id:uint — Der Bezeichner des setInterval()-Aufrufs, den Sie wie im folgenden Beispiel einer Variablen zuweisen:
|
Siehe auch
setInterval()-Methode ein Zeitintervall erstellt, und die Methode myRepeatingFunction() wird in regelmäßigen Intervallen von einer Sekunde aufgerufen.
Bei jedem Aufruf der myRepeatingFunction-Methode wird der Wert der counter-Eigenschaft erhöht. Wenn der Wert der stopCount-Eigenschaft erreicht ist, wird die Methode clearInterval() in der Eigenschaft intervalId aufgerufen. Hierbei handelt es sich um eine Referenz-ID für das zuvor erstellte Intervall.
package {
import flash.display.Sprite;
import flash.utils.*;
public class ClearIntervalExample extends Sprite {
private var intervalDuration:Number = 1000; // duration between intervals, in milliseconds
private var intervalId:uint;
private var counter:uint = 0;
private var stopCount:uint = 3;
public function ClearIntervalExample() {
intervalId = setInterval(myRepeatingFunction, intervalDuration, "Hello", "World");
}
public function myRepeatingFunction():void {
trace(arguments[0] + " " + arguments[1]);
counter++;
if(counter == stopCount) {
trace("Clearing Interval");
clearInterval(intervalId);
}
}
}
}| clearTimeout | () | Funktion |
public function clearTimeout(id:uint):void
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Bricht den angegebenen Aufruf von setTimeout() ab.
Parameter
id:uint — Der Bezeichner des setTimeout()-Aufrufs, den Sie wie im folgenden Beispiel einer Variablen zuweisen:
|
Siehe auch
setTimeout()-Methode eine weitere Methode nach einer angegebenen Verzögerung aufgerufen.
Es wird eine Schleife mit einer Million Durchläufen erstellt. Wenn der Computer die Anforderung bearbeiten kann, bevor eine zweite Anforderung ihre Gültigkeit verliert, wird durch clearTimeout() die setTimeout()-Anforderung gelöscht, und myDelayedFunction() wird nicht aufgerufen.
package {
import flash.display.Sprite;
import flash.utils.*;
public class ClearTimeoutExample extends Sprite {
private var delay:Number = 1000; // delay before calling myDelayedFunction
private var intervalId:uint;
private var count:uint = 1000000;
public function ClearTimeoutExample() {
intervalId = setTimeout(myDelayedFunction, delay);
startCounting();
}
public function startCounting():void {
var i:uint = 0;
do {
if(i == count-1) {
clearTimeout(intervalId);
trace("Your computer can count to " + count + " in less than " + delay/1000 + " seconds.");
}
i++;
} while(i < count)
}
public function myDelayedFunction():void {
trace("Time expired.");
}
}
}| describeType | () | Funktion |
public function describeType(value:*):XML
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Erstellt ein XML-Objekt, das das als Parameter der Methode angegebene ActionScript-Objekt beschreibt. Diese Methode implementiert das Programmierkonzept von reflection für die ActionScript-Programmiersprache.
Wenn der Parameter value eine Instanz eines bestimmten Typs ist, enthält das zurückgegebene XML-Objekt alle Instanzeigenschaften dieses Typs, jedoch nicht die statischen Eigenschaften. Sie können dies beim Analysieren des XML-Objekts feststellen, indem Sie das Attribut des Tags <type> isStatic überprüfen. Dieses Attribut hat den Wert false, wenn der Parameter value eine Instanz eines Typs ist.
Um die statischen Eigenschaften eines Typs zu erhalten, müssen Sie als Parameter value den Typ selbst übergeben. Das zurückgegebene XML-Objekt enthält nicht nur die statischen Eigenschaften des Typs, sondern auch alle entsprechenden Instanzeigenschaften. Die Instanzeigenschaften sind innerhalb eines Tags mit der Bezeichnung <factory> zusammengefasst und unterscheiden sich so von den statischen Eigenschaften. In diesem Fall hat das Attribut isStatic des Tags <type> den Wert true.
Hinweis: Wenn Sie nur die Vererbungshierarchie eines Objekts überprüfen möchten und die durch describeType() bereitgestellten weiteren Informationen nicht benötigen, verwenden Sie stattdessen die Funktionen getQualifiedClassName() und getQualifiedSuperclassName().
Die folgende Tabelle enthält einige der Tags und Attribute von XML-Objekten, die mit describeType() erzeugt werden.
| Tag | Attribut | Beschreibung |
|---|---|---|
<type> | Das Haupt-Tag des XML-Objekts. | |
| name | Der Name des Datentyps des ActionScript-Objekts. | |
| base | Die direkt übergeordnete Klasse der Definitionsklasse des ActionScript-Objekts. Wenn das ActionScript-Objekt ein Klassenobjekt ist, lautet der Wert Class. |
|
| isDynamic | true, wenn die Definitionsklasse des ActionScript-Objekts dynamisch ist, sonst false. Wenn das ActionScript-Objekt ein Klassenobjekt ist, lautet der Wert true, da die Class-Klasse dynamisch ist. |
|
| isFinal | true, wenn die Definitionsklasse des ActionScript-Objekts final ist, sonst false. |
|
| isStatic | true, wenn das ActionScript-Objekt ein Klassenobjekt oder eine Konstruktorfunktion ist, sonst false. Dieses Attribut hat die Bezeichnung isStatic, da beim Wert true alle nicht im Tag factory verschachtelten Tags statisch sind. |
|
<extendsClass> | Für jede übergeordnete Klasse der Definitionsklasse des ActionScript-Objekts gibt es ein eigenes extendsClass-Tag. |
|
| type | Der Name einer übergeordneten Klasse, die die Definitionsklasse des ActionScript-Objekts erweitert. | |
<implementsInterface> | Für jede von der Definitionsklasse des ActionScript-Objekts oder einer ihrer übergeordneten Klassen implementierten Schnittstelle gibt es ein eigenes Tag implementsInterface. |
|
| type | Der Name einer Schnittstelle, die über die Definitionsklasse des ActionScript-Objekts implementiert wird. | |
<accessor> | Dies ist eine Eigenschaft, die von Funktionen zum Abrufen und Setzen von Werten definiert wird. | |
| name | Der Name der accessor-Eigenschaft. | |
| access | Die Zugriffsrechte der Eigenschaft. Mögliche Werte sind u. a. readonly, writeonly und readwrite. |
|
| type | Der Datentyp der Eigenschaft. | |
| declaredBy | Die Klasse, die die zugeordneten get-/set-Funktionen enthält. | |
<constant> | Eine Konstante ist eine mit der const-Anweisung definierte Eigenschaft. |
|
| name | Der Name der Konstante. | |
| type | Der Datentyp der Konstante. | |
<method> | Eine Methode ist eine als Teil einer Klassendefinition deklarierte Funktion. | |
| name | Der Name der Methode. | |
| declaredBy | Die Klasse, die die Methodendefinition enthält. | |
| returnType | Der Datentyp des Rückgabewerts der Methode. | |
<parameter> | Für jeden von einer Methode definierten Parameter gibt es ein eigenes parameter-Tag. Dieses Tag ist immer innerhalb eines <method>-Tags geschachtelt. |
|
| index | Ein Zahlenwert, der der Position des Parameters in der Parameterliste der Methode entspricht. Der erste Parameter hat den Wert 1. | |
| type | Der Datentyp des Parameters. | |
| optional | true, wenn der Parameter optional ist, andernfalls false. |
|
<variable> | Eine Variable ist eine mit der var-Anweisung definierte Eigenschaft. |
|
| name | Der Name der Variablen. | |
| type | Der Datentyp der Variablen. | |
<factory> | Wenn das ActionScript-Objekt ein Klassenobjekt oder eine Konstruktorfunktion ist, sind alle Instanzeigenschaften und Methoden innerhalb dieses Tags geschachtelt. Wenn das Attribut isStatic des <type>-Tags den Wert true hat, sind alle nicht im <factory>-Tag verschachtelten Eigenschaften und Methoden statisch. Dieses Tag ist nur vorhanden, wenn das ActionScript-Objekt ein Klassenobjekt oder eine Konstruktorfunktion ist. |
Parameter
value:* — Das Objekt, für das eine Typbeschreibung gewünscht wird. Dieser Methode können beliebige ActionScript-Werte übergeben werden, einschließlich aller verfügbaren ActionScript-Typen, Objektinstanzen, Grunddatentypen wie "uint" und Klassenobjekte.
|
XML — Ein XML-Objekt mit Detailinformationen zu dem als Parameter übergebenen Objekt. Es enthält die folgenden Angaben zum Objekt:
Hinweis: Mit |
Siehe auch
package {
import flash.display.Sprite;
import flash.utils.describeType;
public class DescribeTypeExample extends Sprite {
public function DescribeTypeExample() {
var child:Sprite = new Sprite();
var description:XML = describeType(child);
trace(description..accessor.@name.toXMLString());
}
}
}
| escapeMultiByte | () | Funktion |
public function escapeMultiByte(value:String):String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt in Abhängigkeit vom Wert "System.useCodePage" eine entweder als UTF-8 oder in der System-Codepage codierte, mit Escape-Sequenzen versehene Kopie des Eingabestrings zurück. Durch die Verwendung von "System.useCodePage" können mit dem Player auch ältere, in lokalen Codepages codierte Inhalte wiedergegeben werden, jedoch nur auf Systemen, die diese Codepage verwenden. So werden zum Beispiel als Shift-JIS codierte japanische Daten nur unter einem Betriebssystem ordnungsgemäß in Escape-Sequenzen konvertiert und rückkonvertiert, das als Standard-Codepage Japanisch verwendet.
Parameter
value:String — Der mit Escape-Sequenzen zu versehende String.
|
String — Eine mit Escape-Sequenzen versehene Kopie des Eingabestrings. Wenn "System.useCodePage" den Wert true aufweist, wird zum Umwandeln in Escape-Sequenzen die Codepage des Systems verwendet. Wenn "System.useCodePage" den Wert false aufweist, wird zum Umwandeln in Escape-Sequenzen die Codierung UTF-8 verwendet. Zum Beispiel wird der Eingabestring "Crüe" auf allen Systemen in die Zeichenfolge "Cr%C3%BCe" konvertiert, wenn "System.useCodePage" den Wert false aufweist. Wenn "System.useCodePage" den Wert true aufweist und das System die Codepage "Latin" verwendet, wird "Crüe" in "Cr%FCe" umgewandelt. Wenn das System eine andere Codepage verwendet, die nicht den Buchstaben 'ü' enthält, ist das Ergebnis mit hoher Wahrscheinlichkeit "Cr?e".
|
| getDefinitionByName | () | Funktion |
public function getDefinitionByName(name:String):Object
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt einen Verweis auf das Klassenobjekt der im Parameter name angegebenen Klasse zurück.
Parameter
name:String — Der Name einer Klasse.
|
Object — Gibt einen Verweis auf das Klassenobjekt der im Parameter name angegebenen Klasse zurück.
|
ReferenceError — Es ist keine öffentliche Definition mit dem angegebenen Namen vorhanden.
|
GetDefinitionByNameExample nacheinander fünf orangefarbene Quadrate erstellt. Dies wird in den folgenden Schritten erreicht:
ClassReference-Variable vom Typ "Class" dem Typ "Sprite" zugewiesen.instance instanziiert.instance per Referenz um ein Sprite-Objekt handelt, kann ein Quadrat gezeichnet und der Anzeigeliste mit den für Sprite verfügbaren Methoden hinzugefügt werden.
package {
import flash.display.DisplayObject;
import flash.display.Sprite;
import flash.utils.getDefinitionByName;
public class GetDefinitionByNameExample extends Sprite {
private var bgColor:uint = 0xFFCC00;
private var size:uint = 80;
public function GetDefinitionByNameExample() {
var ClassReference:Class = getDefinitionByName("flash.display.Sprite") as Class;
var instance:Object = new ClassReference();
instance.graphics.beginFill(bgColor);
instance.graphics.drawRect(0, 0, size, size);
instance.graphics.endFill();
addChild(DisplayObject(instance));
}
}
}| getQualifiedClassName | () | Funktion |
public function getQualifiedClassName(value:*):String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den vollständig qualifizierten Klassennamen eines Objekts zurück.
Parameter
value:* — Das Objekt, für das ein vollständig qualifizierter Klassenname gewünscht wird. Dieser Methode können beliebige ActionScript-Werte übergeben werden, einschließlich aller verfügbaren ActionScript-Typen, Objektinstanzen, Grunddatentypen wie "uint" und Klassenobjekte.
|
String — Ein String mit dem vollständig qualifizierten Klassennamen.
|
Siehe auch
| getQualifiedSuperclassName | () | Funktion |
public function getQualifiedSuperclassName(value:*):String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt den vollständig qualifizierten Klassennamen der Basisklasse des im Parameter value angegebenen Objekts zurück. Diese Funktion stellt eine schnellere Möglichkeit zum Abrufen des Basisklassennamens dar als describeType(), gibt jedoch nicht alle der Informationen zurück, die describeType() liefert.
Nachdem Sie mit dieser Funktion den Namen einer Klasse abgerufen haben, können Sie diesen mit der Funktion getDefinitionByName() in einen Klassenverweis umwandeln.
Hinweis: Diese Funktion ist auf Instanzhierarchien beschränkt, während die describeType()-Funktion Klassenobjekthierarchien verwendet, wenn der Parameter value ein Datentyp ist. Der Aufruf von describeType() für einen Datentyp gibt die anhand der Klassenobjekthierarchie ermittelte übergeordnete Klasse zurück. In der Klassenobjekthierarchie erben alle Klassenobjekte von "Class". Die getQualifiedSuperclassName()-Funktion ignoriert jedoch die Klassenobjekthierarchie und gibt die übergeordnete Klasse anhand der vertrauteren Instanzhierarchie zurück. Zum Beispiel gibt der Aufruf von getQualifiedSuperclassName(String) den Wert Object zurück, obwohl technisch gesehen das String-Klassenobjekt von "Class" geerbt wird. Anders ausgedrückt führt der Aufruf mit einer Instanz eines Typs oder mit dem Typ selbst zum selben Ergebnis.
Parameter
value:* — Ein beliebiger Wert.
|
String — Ein vollständig qualifizierter Basisklassenname oder null, wenn keiner vorhanden ist.
|
Siehe auch
| getTimer | () | Funktion |
public function getTimer():int
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt die Anzahl der Millisekunden zurück, die seit dem Initialisieren von Flash Player vergangen sind, und wird zum Berechnen von Zeitdifferenzen verwendet. Informationen zu einem Kalenderdatum (Zeitstempel) finden Sie bei den Angaben zum Date-Objekt.
Rückgabewerteint — Die Anzahl der Millisekunden seit dem Initialisieren von Flash Player. Wenn der Player die Wiedergabe einer SWF-Datei startet und später eine weitere SWF-Datei geladen wird, stellt der Rückgabewert die Differenz zum Zeitpunkt des Ladens der ersten SWF-Datei dar.
|
Siehe auch
GetTimerExample ermittelt und angezeigt, wie viele Millisekunden seit dem Wiedergabestart in Flash Player vergangen sind.
package {
import flash.utils.getTimer;
import flash.display.Sprite;
public class GetTimerExample extends Sprite {
public function GetTimerExample() {
var duration:uint = getTimer();
trace("duration: " + duration);
}
}
}
| setInterval | () | Funktion |
public function setInterval(closure:Function, delay:Number, ... arguments):uint
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Führt eine Funktion in bestimmten Intervallen aus (Angabe in Millisekunden).
Obwohl Sie die Methode verwenden können, wird eine Compilerwarnung erzeugt. Anstelle der setInterval()-Methode sollten Sie besser ein Timer-Objekt mit dem angegebenen Intervall erstellen und als Parameter repeatCount den Wert 0 (endlose Wiederholung) verwenden.
Wenn Sie zum Abbrechen des setInterval()-Aufrufs die clearInterval()-Methode verwenden möchten, achten Sie darauf, den Rückgabewert des setInterval()-Aufrufs einer Variablen zuzuweisen (die dann von der setInterval()-Methode verwendet wird), wie im folgenden Beispiel dargestellt:
Parameter
closure:Function — Der Name der auszuführenden Funktion. Der Name darf keine Anführungszeichen oder Klammern sowie keine Parameter der aufzurufenden Funktion enthalten. Verwenden Sie beispielsweise functionName und nicht functionName() oder functionName(param).
|
|
delay:Number — Das Intervall in Millisekunden.
|
|
... arguments — Eine optionale Liste von Parametern, die an die closure-Funktion übergeben werden.
|
uint — Eindeutiger numerischer Bezeichner für den in Intervallen auszuführenden Prozess.
|
Siehe auch
setInterval()-Methode ein Zeitintervall erstellt, und die Methode myRepeatingFunction() wird in regelmäßigen Intervallen von einer Sekunde aufgerufen.
package {
import flash.display.Sprite;
import flash.utils.*;
public class SetIntervalExample extends Sprite {
private var intervalDuration:Number = 1000; // duration between intervals, in milliseconds
public function SetIntervalExample() {
var intervalId:uint = setInterval(myRepeatingFunction, intervalDuration, "Hello", "World");
}
public function myRepeatingFunction():void {
trace(arguments[0] + " " + arguments[1]);
}
}
}| setTimeout | () | Funktion |
public function setTimeout(closure:Function, delay:Number, ... arguments):uint
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Führt eine bestimmte Funktion nach der angegebenen Verzögerung aus (Angabe in Millisekunden).
Erstellen Sie besser ein Timer-Objekt mit dem angegebenen Intervall, und verwenden Sie als Parameter repeatCount den Wert 1 (einmalige Ausführung), statt diese Methode einzusetzen.
Wenn Sie die clearTimeout()-Methode zum Abbrechen des setTimeout()-Aufrufs verwenden möchten, achten Sie darauf, den Rückgabewert des setTimeout()-Aufrufs einer Variablen zuzuweisen (die dann von der clearTimeout()-Methode verwendet wird), wie im folgenden Beispiel dargestellt:
Parameter
closure:Function — Der Name der auszuführenden Funktion. Der Name darf keine Anführungszeichen oder Klammern sowie keine Parameter der aufzurufenden Funktion enthalten. Verwenden Sie beispielsweise functionName und nicht functionName() oder functionName(param).
|
|
delay:Number — Die Verzögerung in Millisekunden, bis die Funktion ausgeführt wird.
|
|
... arguments — Eine optionale Liste von Parametern, die an die closure-Funktion übergeben werden.
|
uint — Eindeutiger numerischer Bezeichner für den in Intervallen auszuführenden Prozess.
|
Siehe auch
setTimeout()-Methode eine weitere Methode nach einer angegebenen Verzögerung aufgerufen.
package {
import flash.display.Sprite;
import flash.utils.*;
public class SetTimeoutExample extends Sprite {
private var delay:Number = 1000; // delay before calling myDelayedFunction
public function SetTimeoutExample() {
var intervalId:uint = setTimeout(myDelayedFunction, delay, "Hello", "World");
}
public function myDelayedFunction():void {
trace(arguments[0] + " " + arguments[1]);
}
}
}| unescapeMultiByte | () | Funktion |
public function unescapeMultiByte(value:String):String
| Sprachversion : | ActionScript 3.0 |
| Player-Version : | Flash Player 9 |
Gibt in Abhängigkeit vom Wert "System.useCodePage" eine entweder aus UTF-8 oder aus der System-Codepage decodierte Kopie des Eingabestrings ohne Escape-Sequenzen zurück. Durch die Verwendung von "System.useCodePage" können mit dem Player auch ältere, in lokalen Codepages codierte Inhalte wiedergegeben werden, jedoch nur auf Systemen, die diese Codepage verwenden. So werden zum Beispiel als Shift-JIS codierte japanische Daten nur unter einem Betriebssystem ordnungsgemäß in Escape-Sequenzen konvertiert und rückkonvertiert, das als Standard-Codepage Japanisch verwendet.
Parameter
value:String — Der mit Escape-Sequenzen versehene String, der rückkonvertiert werden soll.
|
String — Eine Kopie des Eingabestrings ohne Escape-Sequenzen. Wenn "System.useCodePage" den Wert true aufweist, wird zum Umwandeln der Escape-Sequenzen die Codepage des Systems verwendet. Wenn "System.useCodePage" den Wert false aufweist, werden die Escape-Sequenzen aus der Codierung UTF-8 rückkonvertiert. Zum Beispiel wird der Eingabestring "Cr%C3%BCe" auf allen Systemen in die Zeichenfolge "Crüe" konvertiert, wenn "System.useCodePage" den Wert false aufweist. Wenn "System.useCodePage" den Wert true aufweist und der Eingabestring "Cr%FCe" lautet, ist das Ergebnis auf Systemen mit einer lateinischen Codepage ebenfalls "Crüe". Wenn "System.useCodePage" den Wert true hat, führt das Entfernen der Escape-Sequenzen aus dem Eingabestring "Cr%C3%BCe" je nach System zu unterschiedlichen falschen Ergebnissen, beispielsweise zu "Crüe" auf Systemen mit lateinischer Codepage. Ebenso führt das Entfernen der Escape-Sequenzen aus dem Eingabestring "Cr%FCe" zu "Cre", "Cr?e" oder je nach Codepage zu anderen Varianten, wenn "System.useCodePage" den Wert false hat.
|
Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht
Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/utils/package.html