ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
Oberste Ebene 

RangeError  - AS3

PaketOberste Ebene
Klassepublic dynamic class RangeError
VererbungRangeError Inheritance Error Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 9, AIR 1.0, Flash Lite 4

Es wird eine RangeError-Ausnahme ausgelöst, wenn ein numerischer Wert außerhalb des akzeptierbaren Bereichs liegt. Wenn Sie mit Arrays arbeiten und auf die Indexposition eines Arrays verweisen, die gar nicht existiert, wird eine RangeError-Ausnahme ausgelöst. Bei Verwendung der Methoden Number.toExponential(), Number.toPrecision() und Number.toFixed() wird eine RangeError-Ausnahme ausgelöst, wenn sich die Argumente außerhalb des akzeptierbaren Zahlenbereichs befinden. Sie können Number.toExponential(), Number.toPrecision() und Number.toFixed() erweitern, um einen solchen RangeError-Fehler zu vermeiden.

Auch die folgenden Situationen können diese Ausnahme verursachen:

  • Jede API einer Flash-Laufzeitumgebung, die eine Zahl für die Tiefe erwartet, wird mit einer unzulässigen Tiefennummer aufgerufen.
  • Jede API einer Flash-Laufzeitumgebung, die eine Zahl für die Bildposition erwartet, wird mit einer unzulässigen Bildnummer aufgerufen.
  • Jede API einer Flash-Laufzeitumgebung, die eine Zahl für die Ebenennummer erwartet, wird mit einer unzulässigen Ebenennummer aufgerufen.

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritederrorID : int
[schreibgeschützt] Enthält die Verweisnummer der zugeordneten Fehlermeldung.
Error
 Inheritedmessage : String
Enthält die mit dem Error-Objekt verbundene Meldung.
Error
 Inheritedname : String
Enthält den Namen des Error-Objekts.
Error
Öffentliche Methoden
 MethodeDefiniert von
  
RangeError(message:String = "")
Erstellt ein neues RangeError-Objekt.
RangeError
 Inherited
Gibt den Aufrufstapel für einen Fehler zum Zeitpunkt der Fehlerentstehung als String zurück.
Error
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
[override] Gibt in der Standardeinstellung den String „Error“ oder, sofern definiert, den in der Error.message-Eigenschaft enthaltenen Wert zurück.
Error
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Konstruktordetails

RangeError

()Konstruktor
public function RangeError(message:String = "")

Laufzeitversionen: Flash Lite 4, Flash Player 9, AIR 1.0

Erstellt ein neues RangeError-Objekt.

Parameter
message:String (default = "") — Enthält die mit dem RangeError-Objekt verbundene Meldung.
RangeErrorExample.as

Dieses Beispiel veranschaulicht, wie eine RangeError-Ausnahme erzeugt und in einertry..catch-Anweisung verarbeitet wird.
package {
    import flash.display.Sprite;

    public class RangeErrorExample extends Sprite {

        public function RangeErrorExample() {
            var child:Sprite = new Sprite();
            try {
                addChildAt(child, 1);
            }
            catch(e:RangeError) {
                trace(e);
            }
        }
    }
}




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.