Paqueteflash.display
Clasepublic class LoaderInfo
HerenciaLoaderInfo Inheritance EventDispatcher Inheritance Object

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

La clase LoaderInfo proporciona información sobre un archivo SWF cargado o un archivo de imagen cargado (JPEG, GIF o PNG). Los objetos LoaderInfo están disponibles para cualquier objeto de visualización. La información mostrada incluye el progreso de la carga, las URL del cargador y el contenido cargado, el número total de bytes del medio, así como la anchura y la altura nominal del medio.

Puede obtener acceso a los objetos LoaderInfo de dos maneras:

La propiedad contentLoaderInfo de un objeto Loader proporciona información sobre el contenido que está cargando el objeto Loader, mientras que la propiedad loaderInfo de un objeto DisplayObject proporciona información sobre el archivo SWF raíz de dicho objeto de visualización.

La propiedad loaderInfo de un objeto cargado con un objeto Loader (un archivo SWF o un mapa de bits) hace referencia al mismo objeto LoaderInfo que la propiedad contentLoaderInfo del objeto Loader. Dicho de otro modo, un objeto LoaderInfo se comparte entre un archivo de objeto cargado y el objeto Loader que lo ha cargado. Dado que la instancia de la clase principal del archivo SWF no tiene objeto Loader, la propiedad loaderInfo es la única forma de obtener acceso a LoaderInfo para la instancia de la clase principal del archivo SWF.

El siguiente gráfico muestra los diferentes usos del objeto LoaderInfo para la instancia de la clase principal del archivo SWF, para la propiedad contentLoaderInfo de un objeto Loader y la propiedad loaderInfo de un objeto cargado:

Cuando una operación de carga no ha finalizado, algunas de las propiedades de la propiedad contentLoaderInfo de un objeto Loader no están disponibles. Puede obtener algunas propiedades, como bytesLoaded, bytesTotal, url, loaderURL y applicationDomain. Cuando el objeto loaderInfo distribuye el evento init, puede obtener acceso a todas las propiedades del objeto loaderInfo y la imagen cargada o el archivo SWF.

Nota: todas la propiedades de los objetos LoaderInfo son de sólo lectura.

El método EventDispatcher.dispatchEvent() no se aplica a los objetos LoaderInfo. Si llama a dispatchEvent() en un objeto LoaderInfo, se emitirá una excepción IllegalOperationError.

Ver los ejemplos

Véase también

flash.display.Loader
flash.display.Loader.content
flash.display.DisplayObject
flash.display.DisplayObject.loaderInfo
Supervisión del progreso de carga


Propiedades públicas
 PropiedadDefinido por
  actionScriptVersion : uint
[read-only] La versión de ActionScript del archivo SWF cargado.
LoaderInfo
  applicationDomain : ApplicationDomain
[read-only] Cuando se carga un archivo SWF externo, todas las definiciones de ActionScript 3.0 contenidas en la clase cargada se almacenan en la propiedad applicationDomain.
LoaderInfo
  bytes : ByteArray
[read-only] Los bytes asociados al objeto LoaderInfo.
LoaderInfo
  bytesLoaded : uint
[read-only] Número de bytes cargados para el medio.
LoaderInfo
  bytesTotal : uint
[read-only] El número de bytes comprimidos en todo el archivo multimedia.
LoaderInfo
  childAllowsParent : Boolean
[read-only] Expresa la relación de confianza del contenido (elemento secundario) hacia el Loader (elemento principal).
LoaderInfo
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  content : DisplayObject
[read-only] El objeto cargado asociado a este objeto LoaderInfo.
LoaderInfo
  contentType : String
[read-only] El tipo MIME del archivo cargado.
LoaderInfo
  frameRate : Number
[read-only] La velocidad de fotogramas nominal, en fotogramas por segundo, del archivo SWF cargado.
LoaderInfo
  height : int
[read-only] Altura nominal del archivo cargado.
LoaderInfo
  loader : Loader
[read-only] El objeto Loader asociado a este objeto LoaderInfo.
LoaderInfo
  loaderURL : String
[read-only] La URL del archivo SWF que inició la carga del medio descrito por este objeto LoaderInfo.
LoaderInfo
  parameters : Object
[read-only] Objeto que contiene los pares nombre-valor que representan los parámetros proporcionados al archivo SWF cargado.
LoaderInfo
  parentAllowsChild : Boolean
[read-only] Expresa la relación de confianza del Loader (elemento principal) hacia el contenido (elemento secundario).
LoaderInfo
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  sameDomain : Boolean
[read-only] Expresa la relación de dominio entre el elemento cargador y el contenido: true si tienen el mismo dominio de origen; false en caso contrario.
LoaderInfo
  sharedEvents : EventDispatcher
[read-only] Una instancia de EventDispatcher que puede utilizarse para intercambiar eventos entre límites de seguridad.
LoaderInfo
  swfVersion : uint
[read-only] La versión del formato del archivo SWF cargado.
LoaderInfo
  url : String
[read-only] La URL del medio que se está cargando.
LoaderInfo
  width : int
[read-only] Anchura nominal del contenido cargado.
LoaderInfo
Métodos públicos
 MétodoDefinido por
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.
EventDispatcher
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
  
[static] Devuelve el objeto LoaderInfo asociado al archivo SWF definido como objeto.
LoaderInfo
 Inherited
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.
EventDispatcher
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
EventDispatcher
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
 Inherited
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.
EventDispatcher
Eventos
 Evento Resumen Definido por
 Inherited Se distribuye cuando Flash Player queda seleccionado por el sistema operativo y pasa a estar activo.EventDispatcher
   Se distribuye cuando los datos se han cargado correctamente.LoaderInfo
 Inherited Se distribuye cuando Flash Player deja de estar seleccionado por el sistema operativo y pasa a estar inactivo.EventDispatcher
   Se distribuye cuando se realiza una solicitud de red a través de HTTP y Flash Player puede detectar el código de estado HTTP.LoaderInfo
   Se distribuye cuando las propiedades y métodos de un archivo SWF cargado están accesibles.LoaderInfo
   Se distribuye cuando se produce un error de entrada o salida que provoca que una operación de carga se realice incorrectamente.LoaderInfo
   Se distribuye cuando se inicia la operación de carga.LoaderInfo
   Se distribuye al recibirse datos mientras progresa una operación de descarga.LoaderInfo
   Se distribuye mediante un objeto LoaderInfo cuando un objeto cargado se elimina utilizando el método unload() del objeto Loader o cuando el mismo objeto Loader realiza una segunda carga y el contenido original se elimina antes de que comience la carga.LoaderInfo
Información sobre propiedades
actionScriptVersionpropiedad
actionScriptVersion:uint  [read-only]

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

La versión de ActionScript del archivo SWF cargado. La versión del lenguaje se especifica mediante las enumeraciones de la clase ActionScriptVersion, como ActionScriptVersion.ACTIONSCRIPT2 y ActionScriptVersion.ACTIONSCRIPT3.

Nota: esta propiedad siempre tiene el valor ActionScriptVersion.ACTIONSCRIPT2 o ActionScriptVersion.ACTIONSCRIPT3. Tanto ActionScript 1.0 como 2.0 se indican como ActionScriptVersion.ACTIONSCRIPT2 (versión 2.0). Esta propiedad sólo distingue ActionScript 1.0 y 2.0 de ActionScript 3.0.


Implementación
    public function get actionScriptVersion():uint

Emite
Error — Si el archivo no se ha descargado lo suficiente como para recuperar la información solicitada.
 
Error — Si el archivo no es un archivo SWF.

Véase también

applicationDomainpropiedad 
applicationDomain:ApplicationDomain  [read-only]

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

Cuando se carga un archivo SWF externo, todas las definiciones de ActionScript 3.0 contenidas en la clase cargada se almacenan en la propiedad applicationDomain.

Todo el código de un archivo SWF se define para que exista en un dominio de aplicación. El dominio de aplicación actual es el lugar en el que se ejecuta la aplicación principal. El dominio del sistema contiene todos los dominios de la aplicación, incluido el dominio actual, lo que significa que contiene todas las clases de Flash Player.

Todos los dominios de aplicación tienen asociado un dominio principal, excepto el dominio del sistema. El dominio principal del applicationDomain de la aplicación principal es el dominio del sistema. Sólo es necesario definir las clases cargadas si su clase principal no las ha definido todavía. No es posible anular una definición de clase cargada con otra definición más reciente.

Para consultar ejemplos de dominios de aplicación, consulte el capítulo "Entorno del sistema del cliente" de Programación con ActionScript 3.0.


Implementación
    public function get applicationDomain():ApplicationDomain

Emite
SecurityError — Este entorno limitado de seguridad del elemento que origina la llamada no tiene permitido el acceso a este ApplicationDomain.

Véase también

bytespropiedad 
bytes:ByteArray  [read-only]

Versión del lenguaje: ActionScript 3.0

Los bytes asociados al objeto LoaderInfo.


Implementación
    public function get bytes():ByteArray

Emite
SecurityError — Si al objeto que obtiene acceso a esta API se le impide el acceso al objeto cargado debido a restricciones de seguridad. Esto puede suceder, por ejemplo, cuando un objeto Loader intenta obtener acceso a la propiedad contentLoaderInfo.content y no se le concede permiso de seguridad para obtener acceso al contenido cargado.

Para más información, consulte el capítulo "Seguridad de Flash Player" de Programación con ActionScript 3.0..

Versión del reproductor: Flash Player 9 Update 3.

bytesLoadedpropiedad 
bytesLoaded:uint  [read-only]

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

Número de bytes cargados para el medio. Cuando este número sea igual al valor de bytesTotal, se habrán cargado todos los bytes.


Implementación
    public function get bytesLoaded():uint
bytesTotalpropiedad 
bytesTotal:uint  [read-only]

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

El número de bytes comprimidos en todo el archivo multimedia.

Antes de que el objeto Loader correspondiente a este objeto LoaderInfo distribuya el primer evento progress, bytesTotal es 0. Tras el primer evento progress del objeto Loader, bytesTotal reflejará el número real de bytes descargados.


Implementación
    public function get bytesTotal():uint

Véase también

childAllowsParentpropiedad 
childAllowsParent:Boolean  [read-only]

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

Expresa la relación de confianza del contenido (elemento secundario) hacia el Loader (elemento principal). Si el elemento secundario ha permitido el acceso del elemento principal, el valor es true; en caso contrario, el valor es false. Esta propiedad se define con el valor true si el objeto secundario ha llamado al método allowDomain() para conceder permiso al dominio principal o si hay una política para distintos dominios cargada en el dominio secundario que concede permiso al dominio principal. Si el elemento secundario y el elemento principal están en el mismo dominio, esta propiedad se define con el valor true.

Para más información, consulte el capítulo "Seguridad de Flash Player" de Programación con ActionScript 3.0..


Implementación
    public function get childAllowsParent():Boolean

Emite
Error — Se emite si el archivo no se ha descargado lo suficiente como para recuperar la información solicitada.
contentpropiedad 
content:DisplayObject  [read-only]

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

El objeto cargado asociado a este objeto LoaderInfo.


Implementación
    public function get content():DisplayObject

Emite
SecurityError — Si al objeto que obtiene acceso a esta API se le impide el acceso al objeto cargado debido a restricciones de seguridad. Esto puede suceder, por ejemplo, cuando un objeto Loader intenta obtener acceso a la propiedad contentLoaderInfo.content y no se le concede permiso de seguridad para obtener acceso al contenido cargado.

Para más información, consulte el capítulo "Seguridad de Flash Player" de Programación con ActionScript 3.0..

contentTypepropiedad 
contentType:String  [read-only]

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

El tipo MIME del archivo cargado. El valor es null si el archivo no se ha cargado lo suficiente como para que Flash Player determine el tipo. En la siguiente lista se enumeran los valores posibles:


Implementación
    public function get contentType():String
frameRatepropiedad 
frameRate:Number  [read-only]

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

La velocidad de fotogramas nominal, en fotogramas por segundo, del archivo SWF cargado. Este número suele ser un entero, aunque no tiene por qué serlo necesariamente.

Este valor puede ser diferente de la velocidad de fotogramas realmente utilizada. Flash Player sólo utiliza una velocidad de fotogramas para todos los archivos SWF cargados en un momento concreto y dicha velocidad se determina mediante la velocidad de fotogramas nominal del archivo SWF principal. Asimismo, es posible que Flash Player no pueda alcanzar la velocidad de fotogramas principal, dependiendo del hardware, de la sincronización de sonido y de otros factores.


Implementación
    public function get frameRate():Number

Emite
Error — Si el archivo no se ha descargado lo suficiente como para recuperar la información solicitada.
 
Error — Si el archivo no es un archivo SWF.
heightpropiedad 
height:int  [read-only]

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

Altura nominal del archivo cargado. Este valor puede ser diferente de la altura real con la que se muestra el contenido, ya que es posible que se haya aplicado escala al contenido cargado o a sus objetos de visualización principales.


Implementación
    public function get height():int

Emite
Error — Si el archivo no se ha descargado lo suficiente como para recuperar la información solicitada.
loaderpropiedad 
loader:Loader  [read-only]

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

El objeto Loader asociado a este objeto LoaderInfo. Si el objeto LoaderInfo es la propiedad loaderInfo de la instancia de la clase principal del archivo SWF, no habrá ningún objeto Loader asociado.


Implementación
    public function get loader():Loader

Emite
SecurityError — Si al objeto que obtiene acceso a esta API se le impide el acceso al objeto Loader por restricciones de seguridad. Esto puede suceder, por ejemplo, cuando un archivo SWF cargado intenta obtener acceso a su propiedad loaderInfo.loader y no se le concede permiso de seguridad para obtener acceso al archivo SWF que se está cargando.

Para más información, consulte el capítulo "Seguridad de Flash Player" de Programación con ActionScript 3.0..

loaderURLpropiedad 
loaderURL:String  [read-only]

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

La URL del archivo SWF que inició la carga del medio descrito por este objeto LoaderInfo. Para la instancia de la clase principal del archivo SWF, esta URL es la misma que la del propio archivo SWF.


Implementación
    public function get loaderURL():String
parameterspropiedad 
parameters:Object  [read-only]

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

Objeto que contiene los pares nombre-valor que representan los parámetros proporcionados al archivo SWF cargado.

Puede utilizar un bucle for-in para extraer todos los nombres y valores del objeto parameters.

Las dos fuentes de parámetros son: la cadena de consulta de la URL del archivo SWF principal y el valor del parámetro HTML FlashVars (éste sólo afecta al archivo SWF principal).

La propiedad parameters sustituye a la técnica de ActionScript 1.0 y 2.0 por la que los parámetros del archivo SWF se proporcionan como propiedades de la línea de tiempo principal.

El valor de la propiedad parameters es null para los objetos Loader que contengan archivos SWF que utilicen ActionScript 1.0 o 2.0. El valor sólo es distinto de null para los objetos Loader que contengan archivos SWF que utilicen ActionScript 3.0.


Implementación
    public function get parameters():Object
parentAllowsChildpropiedad 
parentAllowsChild:Boolean  [read-only]

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

Expresa la relación de confianza del Loader (elemento principal) hacia el contenido (elemento secundario). Si el elemento principal ha permitido el acceso del elemento secundario, el valor es true; en caso contrario, es false. Esta propiedad se define con el valor true si el objeto principal ha llamado al método allowDomain() para conceder permiso al dominio secundario o si hay un archivo de política para distintos dominios cargado en el dominio principal que concede permiso al dominio secundario. Si el elemento secundario y el elemento principal están en el mismo dominio, esta propiedad se define con el valor true.

Para más información, consulte el capítulo "Seguridad de Flash Player" de Programación con ActionScript 3.0..


Implementación
    public function get parentAllowsChild():Boolean

Emite
Error — Se emite si el archivo no se ha descargado lo suficiente como para recuperar la información solicitada.
sameDomainpropiedad 
sameDomain:Boolean  [read-only]

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

Expresa la relación de dominio entre el elemento cargador y el contenido: true si tienen el mismo dominio de origen; false en caso contrario.


Implementación
    public function get sameDomain():Boolean

Emite
Error — Se emite si el archivo no se ha descargado lo suficiente como para recuperar la información solicitada.
sharedEventspropiedad 
sharedEvents:EventDispatcher  [read-only]

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

Una instancia de EventDispatcher que puede utilizarse para intercambiar eventos entre límites de seguridad. Aunque el elemento cargador y el elemento cargado no confíen el uno en el otro, ambos pueden obtener acceso a sharedEvents.


Implementación
    public function get sharedEvents():EventDispatcher
swfVersionpropiedad 
swfVersion:uint  [read-only]

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

La versión del formato del archivo SWF cargado. El formato del archivo se especifica mediante las enumeraciones de la clase SWFVersion, como SWFVersion.FLASH7 y SWFVersion.FLASH9.


Implementación
    public function get swfVersion():uint

Emite
Error — Si el archivo no se ha descargado lo suficiente como para recuperar la información solicitada.
 
Error — Si el archivo no es un archivo SWF.

Véase también

urlpropiedad 
url:String  [read-only]

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

La URL del medio que se está cargando.

Antes de que el objeto Loader correspondiente a este objeto LoaderInfo distribuya el primer evento progress, el valor de la propiedad url podría reflejar sólo la URL inicial especificada en la llamada al método load() del objeto Loader. Tras el primer evento progress, la propiedad url reflejará la URL final del medio, después de cualquier redirección y de que se resuelvan las URL relativas.


Implementación
    public function get url():String

Véase también

widthpropiedad 
width:int  [read-only]

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

Anchura nominal del contenido cargado. Este valor puede ser diferente de la anchura real con la que se muestra el contenido, ya que es posible que se haya aplicado escala al contenido cargado o a sus objetos de visualización principales.


Implementación
    public function get width():int

Emite
Error — Si el archivo no se ha descargado lo suficiente como para recuperar la información solicitada.
Información sobre métodos
getLoaderInfoByDefinition()método
public static function getLoaderInfoByDefinition(object:Object):LoaderInfo

Versión del lenguaje: ActionScript 3.0

Devuelve el objeto LoaderInfo asociado al archivo SWF definido como objeto.

Versión del reproductor: Flash Player 9 Update 3.

Parámetros

object:Object — Un objeto de archivo SWF.

Valor devuelto
LoaderInfo — El objeto LoaderInfo asociado.
Información sobre eventos
complete Evento
Tipo de objeto de evento: flash.events.Event
Event.type property = flash.events.Event.COMPLETE

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

Se distribuye cuando los datos se han cargado correctamente. El evento complete siempre se distribuye después del evento init.

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

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 con un detector de eventos.
targetObjeto de red que ha terminado de cargarse.

Véase también

httpStatus Evento  
Tipo de objeto de evento: flash.events.HTTPStatusEvent
HTTPStatusEvent.type property = flash.events.HTTPStatusEvent.HTTP_STATUS

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

Se distribuye cuando se realiza una solicitud de red a través de HTTP y Flash Player puede detectar el código de estado HTTP.

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

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 con un detector de eventos.
statusEl código de estado HTTP que devuelve el servidor.
targetEl objeto de red que recibe el código de estado HTTP.

Véase también

init Evento  
Tipo de objeto de evento: flash.events.Event
Event.type property = flash.events.Event.INIT

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

Se distribuye cuando las propiedades y métodos de un archivo SWF cargado están accesibles. Un objeto LoaderInfo distribuye el evento init cuando se cumplen las dos condiciones siguientes:

El evento init siempre precede al evento complete.

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

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 con un detector de eventos.
targetObjeto LoaderInfo asociado al archivo SWF que se está cargando.

Véase también

ioError Evento  
Tipo de objeto de evento: flash.events.IOErrorEvent
IOErrorEvent.type property = flash.events.IOErrorEvent.IO_ERROR

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

Se distribuye cuando se produce un error de entrada o salida que provoca que una operación de carga se realice incorrectamente.

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

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 con un detector de eventos.
targetEl objeto de red en el que se produce el error de entrada/salida.
textTexto que se mostrará como mensaje de error.

Véase también

open Evento  
Tipo de objeto de evento: flash.events.Event
Event.type property = flash.events.Event.OPEN

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

Se distribuye cuando se inicia la operación de carga.

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

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 con un detector de eventos.
targetObjeto de red que ha abierto una conexión.

Véase también

progress Evento  
Tipo de objeto de evento: flash.events.ProgressEvent
ProgressEvent.type property = flash.events.ProgressEvent.PROGRESS

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

Se distribuye al recibirse datos mientras progresa una operación de descarga.

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

unload Evento  
Tipo de objeto de evento: flash.events.Event
Event.type property = flash.events.Event.UNLOAD

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

Se distribuye mediante un objeto LoaderInfo cuando un objeto cargado se elimina utilizando el método unload() del objeto Loader o cuando el mismo objeto Loader realiza una segunda carga y el contenido original se elimina antes de que comience la carga.

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

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 con un detector de eventos.
targetEl objeto LoaderInfo asociado al archivo SWF que se está descargando o reemplazando.

Véase también

Ejemplos Cómo utilizar los ejemplos
LoaderInfoExample.as

En el ejemplo siguiente, se utiliza la clase LoaderInfoExample para mostrar una imagen en el escenario. Esto se consigue realizando los pasos siguientes:
  1. Se crea una propiedad url, que es la ubicación y el nombre de la imagen.
  2. El constructor de la clase crea un objeto Loader denominado loader.
  3. El objeto loader crea una instancia de un detector de eventos para garantizar que la imagen se carga correctamente.
  4. El constructor crea una nueva instancia de un objeto URLRequest, request, con url para que se conozcan el nombre del archivo y la ubicación.
  5. El objeto request se transfiere después al método load() del objeto loader, que carga la imagen en la lista de visualización.

Importante: este ejemplo requiere que añada un archivo denominado Image.gif al mismo directorio que el archivo SWF compilado. Utilice una imagen que tenga un área que se ajuste a las dimensiones del archivo SWF principal.

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

    public class LoaderInfoExample extends Sprite {
        private var url:String = "Image.gif";

        public function LoaderInfoExample() {
            var loader:Loader = new Loader();
            loader.contentLoaderInfo.addEventListener(Event.INIT, initHandler);
            loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            var request:URLRequest = new URLRequest(url);
            loader.load(request);
            addChild(loader);
        }

        private function initHandler(event:Event):void {
            var loader:Loader = Loader(event.target.loader);
            var info:LoaderInfo = LoaderInfo(loader.contentLoaderInfo);
            trace("initHandler: loaderURL=" + info.loaderURL + " url=" + info.url);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}




 

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/display/LoaderInfo.html