| Package | flash.events |
| Classe | public class ErrorEvent |
| Héritage | ErrorEvent TextEvent Event Object |
| Sous-classes | AsyncErrorEvent, DownloadErrorEvent, DRMAuthenticationErrorEvent, DRMErrorEvent, IOErrorEvent, SecurityErrorEvent, SkinErrorEvent, SQLErrorEvent, StatusFileUpdateErrorEvent, StatusUpdateErrorEvent |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
error : ErrorEvent.ERROR.
La classe ErrorEvent sert également de classe de base pour les classes AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent et SQLErrorEvent.
Vous pouvez rechercher des événements error qui n'ont pas d'écouteurs en utilisant la version débogueur de Flash Player ou l'application de débogage du lanceur AIR. La version débogueur de Flash Player ou l'application de débogage du lanceur AIR affiche ces événements sous forme de chaînes (définies par le paramètre text du constructeur ErrorEvent).
| Propriété | Défini par | ||
|---|---|---|---|
![]() | bubbles : Boolean [lecture seule] Indique si un événement peut se propager vers le haut (bubbling). | Event | |
![]() | cancelable : Boolean [lecture seule] Indique si le comportement associé à l'événement peut être annulé. | Event | |
![]() | constructor : Object Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet. | Object | |
![]() | currentTarget : Object [lecture seule] L'objet qui traite activement l'objet Event avec un écouteur d'événements. | Event | |
[lecture seule] Contient le numéro de référence associé à l'erreur spécifique. | ErrorEvent | ||
![]() | eventPhase : uint [lecture seule] Phase actuelle du flux d'événements. | Event | |
![]() | prototype : Object [statique] Référence à l'objet prototype d'un objet de classe ou fonction. | Object | |
![]() | target : Object [lecture seule] Cible de l'événement. | Event | |
![]() | text : String Dans le cas d'un événement textInput, caractère ou suite de caractères entré par l'utilisateur. | TextEvent | |
![]() | type : String [lecture seule] Type d'événement. | Event | |
| Méthode | Défini par | ||
|---|---|---|---|
ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0) 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 | ||
![]() | Fonction d'un utilitaire permettant d'implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées. | Event | |
![]() | Indique si la propriété spécifiée d'un objet est définie. | Object | |
![]() | Vérifie si la méthode preventDefault() a été appelée pour l'événement. | Event | |
![]() | 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 | |
![]() | Annule le comportement par défaut d'un événement si cette opération est possible. | Event | |
![]() | Indique si la propriété spécifiée existe et est énumérable. | Object | |
![]() | Définit la disponibilité d'une propriété dynamique pour les opérations en boucle. | Object | |
![]() | Bloque le traitement des écouteurs d'événement dans le nœud actuel et les suivants dans le flux d'événements. | Event | |
![]() | 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 | ||
![]() | Renvoie la valeur primitive de l'objet spécifié. | Object | |
| Constante | Défini par | ||
|---|---|---|---|
![]() | ACTIVATE : String = "activate" [statique] La constante ACTIVATE définit la valeur de la propriété type d'un objet événement activate. | Event | |
![]() | ADDED : String = "added" [statique] La constante Event.ADDED définit la valeur de la propriété type d'un objet événement added. | Event | |
![]() | ADDED_TO_STAGE : String = "addedToStage" [statique] La constante Event.ADDED_TO_STAGE définit la valeur de la propriété type d'un objet d'événement addedToStage. | Event | |
![]() | CANCEL : String = "cancel" [statique] La constante Event.CANCEL définit la valeur de la propriété type d'un objet événement cancel. | Event | |
![]() | CHANGE : String = "change" [statique] La constante Event.CHANGE définit la valeur de la propriété type de l'objet d'événement change. | Event | |
![]() | CLEAR : String = "clear" [statique] La constante Event.CLEAR définit la valeur de la propriété type d'un objet événement clear. | Event | |
![]() | CLOSE : String = "close" [statique] La constante Event.CLOSE définit la valeur de la propriété type d'un objet événement close. | Event | |
![]() | [statique] La constante Event.CLOSING définit la valeur de la propriété type d'un objet événement closing. | Event | |
![]() | COMPLETE : String = "complete" [statique] La constante Event.COMPLETE définit la valeur de la propriété type d'un objet événement complete. | Event | |
![]() | CONNECT : String = "connect" [statique] La constante Event.CONNECT définit la valeur de la propriété type d'un objet événement connect. | Event | |
![]() | COPY : String = "copy" [statique] Définit la valeur de la propriété type d'un objet d'événement copy. | Event | |
![]() | CUT : String = "cut" [statique] Définit la valeur de la propriété type d'un objet d'événement cut. | Event | |
![]() | DEACTIVATE : String = "deactivate" [statique] La constante Event.DEACTIVATE définit la valeur de la propriété type d'un objet événement deactivate. | Event | |
![]() | DISPLAYING : String = "displaying" [statique] La constante Event.DISPLAYING définit la valeur de la propriété type d'un objet événement displaying. | Event | |
![]() | ENTER_FRAME : String = "enterFrame" [statique] La constante Event.ENTER_FRAME définit la valeur de la propriété type d'un objet événement enterFrame. | Event | |
| ERROR : String = "error" [statique] Définit la valeur de la propriété type d'un objet événement error. | ErrorEvent | ||
![]() | EXIT_FRAME : String = "exitFrame" [statique] La constante Event.EXIT_FRAME définit la valeur de la propriété type d'un objet événement exitFrame. | Event | |
![]() | [statique] La constante Event.EXITING définit la valeur de la propriété type de l'objet d'événement exiting. | Event | |
![]() | FRAME_CONSTRUCTED : String = "frameConstructed" [statique] La constante Event.FRAME_CONSTRUCTED définit la valeur de la propriété type d'un objet événement frameConstructed. | Event | |
![]() | FULLSCREEN : String = "fullScreen" [statique] La constante Event.FULL_SCREEN définit la valeur de la propriété type d'un objet événement fullScreen. | Event | |
![]() | [statique] La constante Event.HTML_BOUNDS_CHANGE définit la valeur de la propriété type d'un objet événement htmlBoundsChange. | Event | |
![]() | [statique] La constante Event.HTML_DOM_INITIALIZE définit la valeur de la propriété type d'un objet événement htmlDOMInitialize. | Event | |
![]() | [statique] La constante Event.HTML_RENDER définit la valeur de la propriété type d'un objet événement htmlRender. | Event | |
![]() | ID3 : String = "id3" [statique] La constante Event.ID3 définit la valeur de la propriété type d'un objet événement id3. | Event | |
![]() | INIT : String = "init" [statique] La constante Event.INIT définit la valeur de la propriété type d'un objet événement init. | Event | |
![]() | LINK : String = "link" [statique] Définit la valeur de la propriété type d'un objet événement link. | TextEvent | |
![]() | [statique] La constante Event.LOCATION_CHANGE définit la valeur de la propriété type d'un objet événement locationChange. | Event | |
![]() | MOUSE_LEAVE : String = "mouseLeave" [statique] La constante Event.MOUSE_LEAVE définit la valeur de la propriété type d'un objet événement mouseLeave. | Event | |
![]() | [statique] La constante Event.NETWORK_CHANGE définit la valeur de la propriété type d'un objet événement networkChange. | Event | |
![]() | OPEN : String = "open" [statique] La constante Event.OPEN définit la valeur de la propriété type d'un objet événement open. | Event | |
![]() | PASTE : String = "paste" [statique] La constante Event.PASTE définit la valeur de la propriété type d'un objet événement paste. | Event | |
![]() | REMOVED : String = "removed" [statique] La constante Event.REMOVED définit la valeur de la propriété type d'un objet événement removed. | Event | |
![]() | REMOVED_FROM_STAGE : String = "removedFromStage" [statique] La constante Event.REMOVED_FROM_STAGE définit la valeur de la propriété type d'un objet événement removedFromStage. | Event | |
![]() | RENDER : String = "render" [statique] La constante Event.RENDER définit la valeur de la propriété type d'un objet événement render. | Event | |
![]() | RESIZE : String = "resize" [statique] La constante Event.RESIZE définit la valeur de la propriété type d'un objet événement resize. | Event | |
![]() | SCROLL : String = "scroll" [statique] La constante Event.SCROLL définit la valeur de la propriété type d'un objet événement scroll. | Event | |
![]() | SELECT : String = "select" [statique] La constante Event.SELECT définit la valeur de la propriété type d'un objet événement select. | Event | |
![]() | SELECT_ALL : String = "selectAll" [statique] La constante Event.SELECT_ALL définit la valeur de la propriété type d'un objet événement selectAll. | Event | |
![]() | SOUND_COMPLETE : String = "soundComplete" [statique] La constante Event.SOUND_COMPLETE définit la valeur de la propriété type d'un objet événement soundComplete. | Event | |
![]() | TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [statique] La constante Event.TAB_CHILDREN_CHANGE définit la valeur de la propriété type d'un objet événement tabChildrenChange. | Event | |
![]() | TAB_ENABLED_CHANGE : String = "tabEnabledChange" [statique] La constante Event.TAB_ENABLED_CHANGE définit la valeur de la propriété type d'un objet événement tabEnabledChange. | Event | |
![]() | TAB_INDEX_CHANGE : String = "tabIndexChange" [statique] La constante Event.TAB_INDEX_CHANGE définit la valeur de la propriété type d'un objet événement tabIndexChange. | Event | |
![]() | TEXT_INPUT : String = "textInput" [statique] Définit la valeur de la propriété type d'un objet événement textInput. | TextEvent | |
![]() | UNLOAD : String = "unload" [statique] La constante Event.UNLOAD définit la valeur de la propriété type d'un objet événement unload. | Event | |
![]() | [statique] La constante Event.USER_IDLE définit la valeur de la propriété type d'un objet événement userIdle. | Event | |
![]() | [statique] La constante Event.USER_PRESENT définit la valeur de la propriété type d'un objet événement userPresent. | Event | |
| propriété |
errorID:int [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 |
Contient le numéro de référence associé à l'erreur spécifique. Pour un objet ErrorEvent personnalisé, ce nombre correspond à la valeur du paramètre id fourni dans le constructeur.
public function get errorID():int| ErrorEvent | () | Constructeur |
public function ErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, text:String = "", id:int = 0)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 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ètrestype: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.
| |
id:int (default = 0) — Un numéro de référence à associer à l'erreur spécifique (pris en charge uniquement par Adobe AIR). |
| clone | () | méthode |
override public function clone():Event| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 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éeEvent — Nouvel objet ErrorEvent dont les propriétés ont la même valeur que celles de l'objet d'origine. |
| toString | () | méthode |
override public function toString():String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 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 errorID=valeur ]
String — Chaîne répertoriant toutes les propriétés de l'objet ErrorEvent. |
| ERROR | Constante |
public static const ERROR:String = "error"| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 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 |
|---|---|
bubbles
|
false
|
cancelable
|
false ; il n'existe aucun comportement par défaut à annuler.
|
currentTarget
| L'objet qui traite activement l'objet Event avec un écouteur d'événements. |
target
| Objet qui subit l'échec de l'opération réseau. |
text
| Texte à afficher en tant que message 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();
}
}
}
}