| Package | flash.events |
| Classe | public class ProgressEvent |
| Héritage | ProgressEvent Event Object |
| Sous-classes | VideoProgressEvent |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
ProgressEvent.PROGRESS et ProgressEvent.SOCKET_DATA.
Voir aussi
| Propriété | Défini par | ||
|---|---|---|---|
![]() | bubbles : Boolean [lecture seule] Indique si un événement peut se propager vers le haut (bubbling). | Event | |
| bytesLoaded : Number Nombre d'éléments ou d'octets chargés lors du traitement de l'événement par l'écouteur. | ProgressEvent | ||
| bytesTotal : Number Nombre total d'éléments ou d'octets qui seront chargés si le processus de chargement aboutit. | ProgressEvent | ||
![]() | 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 | |
![]() | 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 | |
![]() | type : String [lecture seule] Type d'événement. | Event | |
| Méthode | Défini par | ||
|---|---|---|---|
ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:Number = 0, bytesTotal:Number = 0) Crée un objet Event contenant des informations sur les événements progress. | ProgressEvent | ||
Crée une copie de l'objet ProgressEvent et définit la valeur de chaque propriété de sorte qu'elle corresponde à la valeur d'origine. | ProgressEvent | ||
![]() | 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 ProgressEvent. | ProgressEvent | ||
![]() | 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 | |
![]() | 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 | |
![]() | [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 | |
| PROGRESS : String = "progress" [statique] Définit la valeur de la propriété type d'un objet événement progress. | ProgressEvent | ||
![]() | 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 | |
| SOCKET_DATA : String = "socketData" [statique] Définit la valeur de la propriété type d'un objet événement socketData. | ProgressEvent | ||
![]() | 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 | |
![]() | 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 | |
| bytesLoaded | propriété |
bytesLoaded:Number [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Nombre d'éléments ou d'octets chargés lors du traitement de l'événement par l'écouteur.
public function get bytesLoaded():Number public function set bytesLoaded(value:Number):void| bytesTotal | propriété |
bytesTotal:Number [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Nombre total d'éléments ou d'octets chargés si le processus de chargement aboutit. Si l'événement progress est distribué/associé à un objet Socket, le bytesTotal est toujours 0 à moins qu'une valeur soit spécifiée dans le paramètre bytesTotal du constructeur. Le nombre réel d'octets renvoyé n'est pas défini et dépend du développeur de l'application.
public function get bytesTotal():Number public function set bytesTotal(value:Number):void| ProgressEvent | () | Constructeur |
public function ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:Number = 0, bytesTotal:Number = 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 progress. Les objets Event sont transmis en tant que paramètres aux écouteurs d'événements.
Paramètrestype:String —
Type de l'événement. Les valeurs possibles sont les suivantes : ProgressEvent.PROGRESS et ProgressEvent.SOCKET_DATA.
| |
bubbles:Boolean (default = false) — Détermine si l'objet Event prend part à la phase de propagation vers le haut (bubbling) du flux d'événements. | |
cancelable:Boolean (default = false) — Détermine si l'objet Event peut être annulé. | |
bytesLoaded:Number (default = 0) — Nombre d'éléments ou d'octets chargés lors du traitement de l'événement par l'écouteur. | |
bytesTotal:Number (default = 0) — Nombre total d'éléments ou d'octets qui seront chargés si le processus de chargement aboutit. |
| 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 ProgressEvent et définit la valeur de chaque propriété de sorte qu'elle corresponde à la valeur d'origine.
Valeur renvoyéeEvent — Nouvel objet ProgressEvent 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 ProgressEvent. La chaîne est écrite au format suivant :
[ProgressEvent type=valeur bubbles=valeur cancelable=valeur bytesLoaded=valeur bytesTotal=valeur ]
String —
Chaîne répertoriant toutes les propriétés de l'objet ProgressEvent.
|
| PROGRESS | Constante |
public static const PROGRESS:String = "progress"| 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 progress.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles
|
false
|
bytesLoaded
| Nombre d'éléments ou d'octets chargés lors du traitement de l'événement par l'écouteur. |
bytesTotal
| Nombre total d'éléments ou d'octets qui seront chargés si le processus de chargement aboutit. |
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 indiquant la progression. |
Voir aussi
| SOCKET_DATA | Constante |
public static const SOCKET_DATA:String = "socketData"| 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 socketData.
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
| Objet qui traite activement l'événement. |
bytesLoaded
| Nombre d'éléments ou d'octets chargés lors du traitement de l'événement par l'écouteur. |
bytesTotal
|
0 ; cette propriété n'est pas utilisée par les objets événement socketData.
|
target
| Objet Socket indiquant la progression. |
Voir aussi
ProgressEventExample pour montrer comment les différents écouteurs d'événement sont utilisés lors du téléchargement d'un fichier. L'exemple exécute les tâches suivantes :
downloadURL et fileName sont créées, et indiquent l'emplacement et le nom du fichier téléchargé.
ProgressEventExample, un nouvel objet FileReference nommé file est créé, puis transmis à la méthode configureListeners().
downloadURL et fileName sont ensuite transmises à la méthode file.download(), qui demande l'emplacement de téléchargement du fichier.
configureListeners() ajoute sept écouteurs d'événement et leurs méthodes d'abonnés associées :
Remarques :
package {
import flash.display.Sprite;
import flash.events.*;
import flash.net.FileReference;
import flash.net.URLRequest;
public class ProgressEventExample extends Sprite {
private var downloadURL:String = "http://www.[yourDomain].com/SomeFile.pdf";
private var fileName:String = "SomeFile.pdf";
private var file:FileReference;
public function ProgressEventExample() {
var request:URLRequest = new URLRequest(downloadURL);
file = new FileReference();
configureListeners(file);
file.download(request, fileName);
}
private function configureListeners(dispatcher:IEventDispatcher):void {
dispatcher.addEventListener(Event.CANCEL, cancelHandler);
dispatcher.addEventListener(Event.COMPLETE, completeHandler);
dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
dispatcher.addEventListener(Event.OPEN, openHandler);
dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
dispatcher.addEventListener(Event.SELECT, selectHandler);
}
private function cancelHandler(event:Event):void {
trace("cancelHandler: " + event);
}
private function completeHandler(event:Event):void {
trace("completeHandler: " + event);
}
private function ioErrorHandler(event:IOErrorEvent):void {
trace("ioErrorHandler: " + event);
}
private function openHandler(event:Event):void {
trace("openHandler: " + event);
}
private function progressHandler(event:ProgressEvent):void {
var file:FileReference = FileReference(event.target);
trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
}
private function securityErrorHandler(event:SecurityErrorEvent):void {
trace("securityErrorHandler: " + event);
}
private function selectHandler(event:Event):void {
var file:FileReference = FileReference(event.target);
trace("selectHandler: name=" + file.name + " URL=" + downloadURL);
}
}
}