Paqueteflash.events
Clasepublic class ProgressEvent
HerenciaProgressEvent Inheritance Event Inheritance Object
Subclases VideoProgressEvent

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Flash® Player distribuye objetos ProgressEvent cuando se inicia una operación de carga o si un socket recibe datos. Estos eventos suelen generarse al cargar archivos SWF, imágenes o datos en Flash Player. Existen dos tipos de eventos de progreso: ProgressEvent.PROGRESS y ProgressEvent.SOCKET_DATA.

Ver los ejemplos

Véase también

Clase LoaderInfo
Clase Socket


Propiedades públicas
 PropiedadDefinido por
 Inheritedbubbles : Boolean
[read-only] Indica si un evento es un evento de propagación.
Event
  bytesLoaded : uint
Número de elementos o bytes cargados cuando el detector procesa el evento.
ProgressEvent
  bytesTotal : uint
Número total de elementos o bytes que se cargarán si el proceso de carga se realiza correctamente.
ProgressEvent
 Inheritedcancelable : Boolean
[read-only] Indica si se puede evitar el comportamiento asociado al evento.
Event
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 InheritedcurrentTarget : Object
[read-only] El objeto que procesa de forma activa el objeto de evento con un detector de eventos.
Event
 InheritedeventPhase : uint
[read-only] La fase actual en el flujo del evento.
Event
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
 Inheritedtarget : Object
[read-only] El destino del evento.
Event
 Inheritedtype : String
[read-only] El tipo de evento.
Event
Métodos públicos
 MétodoDefinido por
  
ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:uint = 0, bytesTotal:uint = 0)
Crea un objeto de evento que contiene información sobre eventos de progreso.
ProgressEvent
  
Crea una copia del objeto ProgressEvent y define el valor de cada propiedad para que coincida con el del objeto original.
ProgressEvent
 Inherited
formatToString(className:String, ... arguments):String
Una función de utilidad para implementar el método toString() en la clase Event personalizada.
Event
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Comprueba si se ha llamado a preventDefault() en el evento.
Event
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo.
Event
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento.
Event
 Inherited
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual.
Event
  
Devuelve una cadena con todas las propiedades del objeto ProgressEvent.
ProgressEvent
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Constantes públicas
 ConstanteDefinido por
 InheritedACTIVATE : String = "activate"
[static] Define el valor de la propiedad type para un objeto de evento activate.
Event
 InheritedADDED : String = "added"
[static] Define el valor de la propiedad type para un objeto de evento added.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] Define el valor de la propiedad type para un objeto de evento addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[static] Define el valor de la propiedad type para un objeto de evento cancel.
Event
 InheritedCHANGE : String = "change"
[static] Define el valor de la propiedad type para un objeto de evento change.
Event
 InheritedCLOSE : String = "close"
[static] Define el valor de la propiedad type para un objeto de evento close.
Event
 InheritedCOMPLETE : String = "complete"
[static] Define el valor de la propiedad type para un objeto de evento complete.
Event
 InheritedCONNECT : String = "connect"
[static] Define el valor de la propiedad type para un objeto de evento connect.
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] Define el valor de la propiedad type para un objeto de evento deactivate.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] Define el valor de la propiedad type para un objeto de evento enterFrame.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] Define el valor de la propiedad type para un objeto de evento fullScreen.
Event
 InheritedID3 : String = "id3"
[static] Define el valor de la propiedad type para un objeto de evento id3.
Event
 InheritedINIT : String = "init"
[static] Define el valor de la propiedad type para un objeto de evento init.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Define el valor de la propiedad type para un objeto de evento mouseLeave.
Event
 InheritedOPEN : String = "open"
[static] Define el valor de la propiedad type para un objeto de evento open.
Event
  PROGRESS : String = "progress"
[static] Define el valor de la propiedad type de un objeto de evento progress.
ProgressEvent
 InheritedREMOVED : String = "removed"
[static] Define el valor de la propiedad type para un objeto de evento removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] Define el valor de la propiedad type para un objeto de evento removedFromStage.
Event
 InheritedRENDER : String = "render"
[static] Define el valor de la propiedad type para un objeto de evento render.
Event
 InheritedRESIZE : String = "resize"
[static] Define el valor de la propiedad type para un objeto de evento resize.
Event
 InheritedSCROLL : String = "scroll"
[static] Define el valor de la propiedad type para un objeto de evento scroll.
Event
 InheritedSELECT : String = "select"
[static] Define el valor de la propiedad type para un objeto de evento select.
Event
  SOCKET_DATA : String = "socketData"
[static] Define el valor de la propiedad type para un objeto de evento socketData.
ProgressEvent
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] Define el valor de la propiedad type para un objeto de evento soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] Define el valor de la propiedad type para un objeto de evento tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] Define el valor de la propiedad type para un objeto de evento tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] Define el valor de la propiedad type para un objeto de evento tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[static] Define el valor de la propiedad type para un objeto de evento unload.
Event
Información sobre propiedades
bytesLoadedpropiedad
bytesLoaded:uint  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Número de elementos o bytes cargados cuando el detector procesa el evento.


Implementación
    public function get bytesLoaded():uint
    public function set bytesLoaded(value:uint):void
bytesTotalpropiedad 
bytesTotal:uint  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Número total de elementos o bytes que se cargarán si el proceso de carga se realiza correctamente.


Implementación
    public function get bytesTotal():uint
    public function set bytesTotal(value:uint):void
Información sobre constructores
ProgressEvent()constructor
public function ProgressEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, bytesLoaded:uint = 0, bytesTotal:uint = 0)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea un objeto de evento que contiene información sobre eventos de progreso. Los objetos de evento se transfieren como parámetros a los detectores de eventos.

Parámetros
type:String — El tipo de evento. Los valores posibles son: ProgressEvent.PROGRESS y ProgressEvent.SOCKET_DATA.
 
bubbles:Boolean (default = false) — Determina si el objeto de evento participa en la fase de propagación del flujo del evento.
 
cancelable:Boolean (default = false) — Determina si se puede cancelar el objeto Event.
 
bytesLoaded:uint (default = 0) — Número de elementos o bytes cargados en el momento en que el detector procesa el evento.
 
bytesTotal:uint (default = 0) — Número total de elementos o bytes que se cargarán si el proceso de carga se realiza correctamente.
Información sobre métodos
clone()método
public override function clone():Event

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea una copia del objeto ProgressEvent y define el valor de cada propiedad para que coincida con el del objeto original.

Valor devuelto
Event — Un nuevo objeto ProgressEvent con valores de propiedades que coinciden con los del objeto original.
toString()método 
public override function toString():String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Devuelve una cadena con todas las propiedades del objeto ProgressEvent. La cadena tiene el siguiente formato:

[ProgressEvent type=value bubbles=value cancelable=value bytesLoaded=value bytesTotal=value]

Valor devuelto
String — Una cadena que contiene todas las propiedades del objeto ProgressEvent.
Información sobre constantes
PROGRESSConstante
public static const PROGRESS:String = "progress"

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Define el valor de la propiedad type de un objeto de evento progress.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
bytesLoadedNúmero de elementos o bytes cargados en el momento en que el detector procesa el evento.
bytesTotalNúmero total de elementos o bytes que se cargarán en última instancia si el proceso de carga se realiza correctamente.
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetEl objeto de red que informa sobre el progreso.

Véase también

SOCKET_DATAConstante 
public static const SOCKET_DATA:String = "socketData"

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Define el valor de la propiedad type de un objeto de evento socketData.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento.
bytesLoadedNúmero de elementos o bytes cargados en el momento en que el detector procesa el evento.
bytesTotal0; los objetos de evento socketData no utilizan esta propiedad.
targetEl objeto Socket que informa sobre el progreso.

Véase también

Ejemplos Cómo utilizar los ejemplos
ProgressEventExample.as

En el ejemplo siguiente, se utiliza la clase ProgressEventExample para ilustrar cómo se usan distintos detectores de eventos cuando se está descargando un archivo. El ejemplo realiza las siguientes tareas:
  1. Se crean las propiedades downloadURL y fileName, que indican la ubicación y el nombre del archivo descargado.
  2. En el constructor ProgressEventExample, se crea un nuevo objeto FileReference llamado file y se transfiere al método configureListeners().
  3. Las propiedades downloadURL y fileName se transfieren al método file.download(), que solicita la ubicación en la que descargar el archivo.
  4. El método configureListeners() añade siete detectores de eventos con los siguientes métodos suscriptores asociados:
    1. cancel/cancelHandler() se distribuye si se cancela la descarga del archivo.
    2. complete/complereHandler() se distribuye si finaliza el proceso de descarga del archivo.
    3. ioError/ioErrorHandler() se distribuye si el archivo que se va a descargar no está disponible ni accesible.
    4. open/openHandler() se distribuye cuando se inicia la operación de descarga.
    5. progress/progressHandler() se distribuye cuando se inicia el proceso de descarga y también cuando finaliza.
    6. securityError/securityErrorHandler se distribuye si la configuración de seguridad local de reproducción no coincide con el tipo de datos de acceso del archivo descargado (local y de red); consulte las notas a continuación.
    7. select/selectHandler() se distribuye cuando se selecciona el objeto descargado.

Notas:


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);
        }
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/events/ProgressEvent.html