Packageflash.events
Classepublic class ErrorEvent
HéritageErrorEvent Inheritance TextEvent Inheritance Event Inheritance Object
Sous-classes AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent, SkinErrorEvent

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Flash® Player distribue des objets ErrorEvent lorsqu’une erreur entraîne l’échec d’une opération réseau. Il n’existe qu'un seul type d'événement error : ErrorEvent.ERROR.

La classe ErrorEvent sert également de classe de base pour les classes IOErrorEvent et SecurityErrorEvent.

Vous pouvez rechercher les événements error qui ne sont pas associés à des écouteurs à l'aide de la version de débogage de Flash Player. La version de débogage de Flash Player affiche ces événements sous forme de chaînes (définies par le paramètretext du constructeur ErrorEvent).

Consulter les exemples



Propriétés publiques
 PropriétéDéfini par
 Inheritedbubbles : Boolean
[lecture-seule] Indique si un événement peut se propager vers le haut (bubbling).
Event
 Inheritedcancelable : Boolean
[lecture-seule] Indique si le comportement associé à l’événement peut être annulé.
Event
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
 InheritedcurrentTarget : Object
[lecture-seule] L’objet qui traite activement l’objet Event avec un écouteur d’événements.
Event
 InheritedeventPhase : uint
[lecture-seule] Phase actuelle du flux d’événements.
Event
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
 Inheritedtarget : Object
[lecture-seule] Cible de l’événement.
Event
 Inheritedtext : String
Dans le cas d'un événement textInput, caractère ou suite de caractères entré par l'utilisateur.
TextEvent
 Inheritedtype : String
[lecture-seule] Type d’événement.
Event
Méthodes publiques
 MéthodeDéfini par
  
ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "")
Crée un objet Event contenant des informations sur les événements d’erreur.
ErrorEvent
  
Crée une copie de l’objet ErrorEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.
ErrorEvent
 Inherited
formatToString(className:String, ... arguments):String
Fonction d’un utilitaire permettant d'implémenter la méthode toString() dans votre classe Event personnalisée.
Event
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Vérifie si preventDefault() a été appelée pour l’événement.
Event
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.
Object
 Inherited
Annule le comportement par défaut d’un événement si cette opération est possible.
Event
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d'événements.
Event
 Inherited
Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements.
Event
  
Renvoie une chaîne répertoriant toutes les propriétés de l'objet ErrorEvent.
ErrorEvent
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
 InheritedACTIVATE : String = "activate"
[static] Définit la valeur de la propriété type d'un objet événement activate.
Event
 InheritedADDED : String = "added"
[static] Définit la valeur de la propriété type d'un objet événement added.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] Définit la valeur de la propriété type d'un objet événement addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[static] Définit la valeur de la propriété type d'un objet événement cancel.
Event
 InheritedCHANGE : String = "change"
[static] Définit la valeur de la propriété type d'un objet événement change.
Event
 InheritedCLOSE : String = "close"
[static] Définit la valeur de la propriété type d'un objet événement close.
Event
 InheritedCOMPLETE : String = "complete"
[static] Définit la valeur de la propriété type d'un objet événement complete.
Event
 InheritedCONNECT : String = "connect"
[static] Définit la valeur de la propriété type d'un objet événement connect.
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] Définit la valeur de la propriété type d'un objet événement deactivate.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] Définit la valeur de la propriété type d'un objet événement enterFrame.
Event
  ERROR : String = "error"
[static] Définit la valeur de la propriété type d'un objet événement error.
ErrorEvent
 InheritedFULLSCREEN : String = "fullScreen"
[static] Définit la valeur de la propriété type d'un objet événement fullScreen.
Event
 InheritedID3 : String = "id3"
[static] Définit la valeur de la propriété type d'un objet événement id3.
Event
 InheritedINIT : String = "init"
[static] Définit la valeur de la propriété type d'un objet événement init.
Event
 InheritedLINK : String = "link"
[static] Définit la valeur de la propriété type d'un objet événement link.
TextEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Définit la valeur de la propriété type d'un objet événement mouseLeave.
Event
 InheritedOPEN : String = "open"
[static] Définit la valeur de la propriété type d'un objet événement open.
Event
 InheritedREMOVED : String = "removed"
[static] Définit la valeur de la propriété type d'un objet événement removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] Définit la valeur de la propriété type d'un objet événement removedFromStage.
Event
 InheritedRENDER : String = "render"
[static] Définit la valeur de la propriété type d'un objet événement render.
Event
 InheritedRESIZE : String = "resize"
[static] Définit la valeur de la propriété type d'un objet événement resize.
Event
 InheritedSCROLL : String = "scroll"
[static] Définit la valeur de la propriété type d'un objet événement scroll.
Event
 InheritedSELECT : String = "select"
[static] Définit la valeur de la propriété type d'un objet événement select.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] Définit la valeur de la propriété type d'un objet événement soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] Définit la valeur de la propriété type d'un objet événement tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] Définit la valeur de la propriété type d'un objet événement tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] Définit la valeur de la propriété type d'un objet événement tabIndexChange.
Event
 InheritedTEXT_INPUT : String = "textInput"
[static] Définit la valeur de la propriété type d'un objet événement textInput.
TextEvent
 InheritedUNLOAD : String = "unload"
[static] Définit la valeur de la propriété type d'un objet événement unload.
Event
Détails du constructeur
ErrorEvent()Constructeur
public function ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "")

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Crée un objet Event contenant des informations sur les événements d’erreur. Les objets Event sont transmis en tant que paramètres aux écouteurs d’événements.

Paramètres
type:String — Type de l’événement. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété type héritée. Il n’existe qu'un seul type d'événement d’erreur : ErrorEvent.ERROR.
 
bubbles:Boolean (default = false) — Détermine si l’objet Event se propage vers le haut. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété bubbles héritée.
 
cancelable:Boolean (default = false) — Détermine si l’objet Event peut être annulé. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété cancelable héritée.
 
text:String (default = "") — Texte à afficher en tant que message d’erreur. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété text.
Détails des méthodes
clone()méthode
public override function clone():Event

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Crée une copie de l’objet ErrorEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.

Valeur renvoyée
Event — Nouvel objet ErrorEvent dont les propriétés ont la même valeur que celles de l’objet d'origine.
toString()méthode 
public override function toString():String

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Renvoie une chaîne répertoriant toutes les propriétés de l'objet ErrorEvent. La chaîne est écrite au format suivant :

[ErrorEvent type=valeur bubbles=valeur cancelable=valeur text=valeur]

Valeur renvoyée
String — Chaîne répertoriant toutes les propriétés de l'objet ErrorEvent.
Détails de la constante
ERRORConstante
public static const ERROR:String = "error"

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Définit la valeur de la propriété type d'un objet événement error.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet qui subit l'échec de l'opération réseau.
textTexte à afficher en tant que message d’erreur.

Exemples Utilisation des exemples
ErrorEventExample.as

L'exemple suivant démontre l'utilisation d'un seul gestionnaire d'erreur (errorHandler()) capturant plusieurs types d'événements error. S'il existe un événement ioError, le gestionnaire tente un chargement à partir du réseau, qui envoie ensuite un objet securityError.

Remarque : cet exemple ne fonctionne pas si un fichier nommé MissingFile.xml se trouve dans le même répertoire que votre fichier SWF.

package {
    import flash.display.Sprite;
    import flash.net.URLLoader;
    import flash.net.URLRequest;
    import flash.events.*;

    public class ErrorEventExample extends Sprite {
        private var loader:URLLoader;
        private var request:URLRequest;
        
        public function ErrorEventExample() {
            loader = new URLLoader();
            loader.addEventListener(IOErrorEvent.IO_ERROR, errorHandler);
            loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, errorHandler);

            request = new URLRequest();
            loadFromFileSystem();
        }
        
        private function loadFromFileSystem():void {
            request.url = "MissingFile.xml";
            loader.load(request);
        }

        private function loadFromNetwork():void {
            request.url = "http://www.[yourDomain].com/MissingFile.xml";
            loader.load(request);
        }
        
        private function errorHandler(event:ErrorEvent):void {
            trace("errorHandler: " + event);
            if(event is IOErrorEvent) {
                loadFromNetwork();
            }
        }
    }
}




 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/events/ErrorEvent.html