Package | flash.events |
Classe | public class ErrorEvent |
Héritage | ErrorEvent TextEvent Event Object |
Sous-classes | AsyncErrorEvent, AugmentedErrorEvent, DownloadErrorEvent, DRMAuthenticationErrorEvent, DRMDeviceGroupErrorEvent, DRMErrorEvent, DRMReturnVoucherErrorEvent, IOErrorEvent, RSLErrorEvent, SecurityErrorEvent, SkinErrorEvent, SQLErrorEvent, StatusFileUpdateErrorEvent, StatusUpdateErrorEvent, UncaughtErrorEvent |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.0, Flash Lite 4 |
La classe ErrorEvent ne définit qu’un seul type d’événement error
: ErrorEvent.ERROR
. La classe ErrorEvent sert également de classe de base pour plusieurs autres classes d’événement d’erreur, y compris les classes AsyncErrorEvent, IOErrorEvent, SecurityErrorEvent et SQLErrorEvent UncaughtErrorEvent.
Vous pouvez rechercher les événements error
qui ne disposent pas d’écouteur en enregistrant un écouteur pour l’événement uncaughtError
(UncaughtErrorEvent.UNCAUGHT_ERROR).
Une erreur non interceptée entraîne par ailleurs l’affichage d’une boîte de dialogue indiquant l’événement d’erreur lorsque le contenu est exécuté dans la version de débogage de Flash Player ou dans l’application de débogage du lanceur AIR (ADL).
Eléments de l’API associés
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 évité. | 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 | ||
errorID : int [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 | ||
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 | ||
[override]
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 la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
[override]
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 | ||
---|---|---|---|
ERROR : String = "error" [statique]
Définit la valeur de la propriété type d’un objet d’événement error. | ErrorEvent |
errorID | propriété |
errorID:int
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 10.1 |
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.
Implémentation
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: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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: | Flash Player 9, AIR 1.0, Flash Lite 4 |
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]
Remarque : la valeur errorId
renvoyée par la méthode toString()
est uniquement disponible pour Adobe AIR. Alors que Flash Player 10.1 prend en charge la propriété errorID
, l’appel de toString()
sur l’objet ErrorEvent ne fournit pas la valeur errorID
dans Flash Player.
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: | Flash Player 9, AIR 1.0, Flash Lite 4 |
Définit la valeur de la propriété type
d’un objet d’é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(); } } } }
Tue Jun 12 2018, 09:30 AM Z