Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: Recupero dati dal server...
Recupero dati dal server...
Primo livello 

RangeError  - AS3

PacchettoPrimo livello
Classepublic dynamic class RangeError
EreditarietàRangeError Inheritance Error Inheritance Object

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 9, AIR 1.0, Flash Lite 4

Un'eccezione RangeError viene generata quando un valore numerico è al di fuori dell'intervallo accettabile. Quando si utilizzano gli array e si fa riferimento a una posizione di indice di un array che non esiste viene generata un'eccezione RangeError. Mediante i metodi Number.toExponential(), Number.toPrecision() e Number.toFixed() viene generata un'eccezione RangeError nei casi in cui gli argomenti sono al di fuori dell'intervallo di numeri accettabile. Per evitare che venga generata un'eccezione RangeError, potete estendere Number.toExponential(), Number.toPrecision() e Number.toFixed().

Questa eccezione viene generata anche in altre situazioni:

  • Qualunque API del runtime Flash che prevede un numero di profondità e viene richiamata con un numero di profondità non valido.
  • Qualunque API del runtime Flash che prevede un numero di fotogramma e viene richiamata con un numero di fotogramma non valido.
  • Qualunque API del runtime Flash che prevede un numero di livello e viene richiamata con un numero di livello non valido.

Vedere gli esempi

Altri esempi

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
 InheritederrorID : int
[sola lettura] Contiene il numero di riferimento associato al messaggio di errore specifico.
Error
 Inheritedmessage : String
Contiene il messaggio associato all'oggetto Error.
Error
 Inheritedname : String
Contiene il nome dell'oggetto Error.
Error
Metodi pubblici
 MetodoDefinito da
  
RangeError(message:String = "")
Crea un nuovo oggetto RangeError.
RangeError
 Inherited
Restituisce lo stack di chiamata per un errore al momento della costruzione dell’errore come stringa.
Error
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
[override] Restituisce la stringa "Error" per impostazione predefinita oppure il valore contenuto nella proprietà Error.message, se definita.
Error
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione della funzione di costruzione

RangeError

()Funzione di costruzione
public function RangeError(message:String = "")

Versioni runtime: Flash Lite 4, Flash Player 9, AIR 1.0

Crea un nuovo oggetto RangeError.

Parametri
message:String (default = "") — Contiene il messaggio associato all'oggetto RangeError.

Altri esempi

RangeErrorExample.as

L'esempio seguente mostra il modo in cui un'eccezione RangeError può essere generata e gestita all'interno di un'istruzione try..catch.
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 ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.