ProLoader

Paquete	fl.display
Clase	public class ProLoader
Herencia	ProLoader Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS5.5

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9

La clase ProLoader carga los archivos o imágenes SWF. Utilice fl.display.ProLoader en lugar de flash.display.Loader al cargar los archivos SWF generados por Flash Professional. Los miembros de la clase ProLoader reflejan los miembros de la case Loader. En lugar de un objeto LoaderInfo, ProLoader utiliza un objeto ProLoaderInfo. Los miembros de la clase ProLoaderInfo reflejan los miembros de la case LoaderInfo.

Nota ProLoader no es una subclase de flash.display.Loader. Para utilizar ProLoader, es necesario cambiar todas las referencias de tipo Loader a ProLoader.

ProLoader ofrece una experiencia de carga coherente. Resulta especialmente útil con archivos SWF que utilizan precarga RSL. Por ejemplo, los archivos SWF que utilizan texto TLF utilizan precarga RSL de forma predeterminada. En estos casos, ProLoaderInfo retrasa el envío del eventos INIT o COMPLETE hasta que ha finalizado la precarga RSL y el contenido real está disponible. Como resultado, la propiedad content puede acceder a contenido real. ProLoader también ayuda a evitar otros problemas, como:

Eventos addedToStage y removedFromStage adicionales
Contenido que se carga en el elemento principal equivocado del fotograma uno (se aplica a contenido publicado en Flash Player 10.2 o superior con Flash Professional CS5.5 o versión superior).

Advertencia Determinados miembros de ProLoader no admiten todas las versiones del motor de ejecución. Acceda a estos miembros sólo cuando su versión de AIR o Flash Player publicada los admita. De lo contrario, estas API emitirán errores en tiempo de ejecución. Los miembros con compatibilidad limitada con el motor de ejecución incluyen los siguientes métodos y propiedad:

unloadAndStop()
loadFilePromise()
uncaughtErrorEvents

Consulte el tema de referencia correspondiente a cada API para verificar su compatibilidad con el motor de ejecución.

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		accessibilityImplementation : AccessibilityImplementation La implementación actual de accesibilidad (AccessibilityImplementation) para esta instancia de InteractiveObject.	InteractiveObject
		accessibilityProperties : AccessibilityProperties Las opciones de accesibilidad actuales para este objeto de visualización.	DisplayObject
		alpha : Number Indica el valor de transparencia alfa del objeto especificado.	DisplayObject
		blendMode : String Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.	DisplayObject
		blendShader : Shader [solo escritura] Define un sombreado para utilizarlo en la mezcla del primer plano y del fondo.	DisplayObject
		buttonMode : Boolean Especifica el modo de botón de este elemento sprite.	Sprite
		cacheAsBitmap : Boolean Si se define como true, los motores de ejecución de Flash dejan en caché una representación interna de mapa de bits del objeto de visualización.	DisplayObject
		cacheAsBitmapMatrix : Matrix Si su valor no es null, este objeto Matrix define cómo un objeto de visualización se procesa cuando cacheAsBitmap se define como true.	DisplayObject
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		content : DisplayObject [solo lectura] Contiene el objeto de visualización raíz del archivo SWF o el archivo de imagen (JPG, PNG o GIF) que se cargó empleando los métodos load() o loadBytes().	ProLoader
		contentLoaderInfo : ProLoaderInfo [solo lectura] Devuelve un objeto ProLoaderInfo que corresponde al objeto que se está cargando.	ProLoader
		contextMenu : NativeMenu Especifica el menú contextual asociado a este objeto.	InteractiveObject
		doubleClickEnabled : Boolean Especifica si este objeto recibe eventos doubleClick.	InteractiveObject
		dropTarget : DisplayObject [solo lectura] Especifica el objeto de visualización sobre el que se está arrastrando el elemento sprite o sobre el que se ha colocado el elemento sprite.	Sprite
		filters : Array Conjunto indexado que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.	DisplayObject
		focusRect : Object Especifica si este objeto muestra un rectángulo de selección.	InteractiveObject
		graphics : Graphics [solo lectura] Especifica el objeto Graphics que pertenece a este elemento sprite, donde pueden ejecutarse comandos de dibujo vectorial.	Sprite
		height : Number Indica la altura del objeto de visualización, expresada en píxeles.	DisplayObject
		hitArea : Sprite Designa otro elemento sprite para que actúe como área activa de un elemento sprite.	Sprite
		loaderInfo : LoaderInfo [solo lectura] Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización.	DisplayObject
		mask : DisplayObject El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado.	DisplayObject
		metaData : Object Obtiene el objeto de metadatos de la instancia de DisplayObject si los metadatos se almacenaron con la instancia de este objeto DisplayObject en el archivo SWF a través de una etiqueta PlaceObject4.	DisplayObject
		mouseChildren : Boolean Determina si los elementos secundarios del objeto están activados para acciones de ratón o de dispositivo de entrada de usuario.	DisplayObjectContainer
		mouseEnabled : Boolean Especifica si este objeto recibe la entrada del ratón, la entrada del usuario o mensajes.	InteractiveObject
		mouseX : Number [solo lectura] Indica la coordenada x de la posición del ratón o del dispositivo de entrada del usuario, en píxeles.	DisplayObject
		mouseY : Number [solo lectura] Indica la coordenada y de la posición del ratón o del dispositivo de entrada del usuario, en píxeles.	DisplayObject
		name : String Indica el nombre de instancia de DisplayObject.	DisplayObject
		needsSoftKeyboard : Boolean Especifica si un teclado virtual (teclado en pantalla) se debe mostrar cuando esta instancia de InteractiveObject recibe la selección.	InteractiveObject
		numChildren : int [solo lectura] Devuelve el número de elementos secundarios de este objeto.	DisplayObjectContainer
		opaqueBackground : Object Especifica si el objeto de visualización es opaco con un determinado color de fondo.	DisplayObject
		parent : DisplayObjectContainer [solo lectura] Indica el objeto DisplayObjectContainer que contiene este objeto de visualización.	DisplayObject
		root : DisplayObject [solo lectura] Para un objeto de visualización en un archivo SWF cargado, la propiedad root es el objeto de visualización de nivel más alto en la parte de la estructura de árbol de la lista de visualización representada por dicho archivo SWF.	DisplayObject
		rotation : Number Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original.	DisplayObject
		rotationX : Number Indica la rotación del eje x de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D.	DisplayObject
		rotationY : Number Indica la rotación del eje y de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D.	DisplayObject
		rotationZ : Number Indica la rotación del eje z de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D.	DisplayObject
		scale9Grid : Rectangle La cuadrícula de escala aplicada actualmente.	DisplayObject
		scaleX : Number Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro.	DisplayObject
		scaleY : Number Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto.	DisplayObject
		scaleZ : Number Indica la escala de profundidad (porcentaje) de un objeto aplicada desde el punto de registro del objeto.	DisplayObject
		scrollRect : Rectangle Los límites del rectángulo de desplazamiento del objeto de visualización.	DisplayObject
		softKeyboard : String Controla la apariencia del teclado virtual.	InteractiveObject
		softKeyboardInputAreaOfInterest : Rectangle Define el área que debe permanecer en pantalla cuando se muestra un teclado virtual (no disponible en iOS).	InteractiveObject
		soundTransform : flash.media:SoundTransform Controla el sonido dentro de este elemento sprite.	Sprite
		stage : Stage [solo lectura] El escenario del objeto de visualización.	DisplayObject
		tabChildren : Boolean Determina si los elementos secundarios del objeto están habilitados para tabulación.	DisplayObjectContainer
		tabEnabled : Boolean Especifica si este objeto está en el orden de tabulación.	InteractiveObject
		tabIndex : int Especifica el orden de tabulación de los objetos de un archivo SWF.	InteractiveObject
		textSnapshot : flash.text:TextSnapshot [solo lectura] Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.	DisplayObjectContainer
		transform : flash.geom:Transform Objeto con propiedades pertenecientes a una matriz, transformación de color y límites de píxel de un objeto de visualización.	DisplayObject
		uncaughtErrorEvents : EventDispatcher [solo lectura] Un objeto que distribuye un evento uncaughtError cuando se produce un error no gestionado en el código de este objeto ProLoader del archivo SWF.	ProLoader
		useHandCursor : Boolean Valor booleano que indica si debe aparecer la mano que señala (cursor de mano) cuando el puntero pasa por encima de un elemento sprite en el que la propiedad buttonMode se ha definido con el valor true.	Sprite
		visible : Boolean Indica si el objeto de visualización es visible.	DisplayObject
		width : Number Indica la anchura del objeto de visualización, expresada en píxeles.	DisplayObject
		x : Number Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.	DisplayObject
		y : Number Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal.	DisplayObject
		z : Number Indica la posición de la coordenada z en el eje z de la instancia de DisplayObject relativa al contenedor principal 3D.	DisplayObject

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		ProLoader() Crea un objeto ProLoader que puede utilizar para cargar archivos como, por ejemplo, archivos SWF, JPEG, GIF o PNG.	ProLoader
		addChild(child:DisplayObject):DisplayObject Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer.	DisplayObjectContainer
		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
		areInaccessibleObjectsUnderPoint(point:Point):Boolean Indica si las restricciones de seguridad provocarían la omisión de objetos de visualización de la lista devuelta al llamar al método DisplayObjectContainer.getObjectsUnderPoint() con el punto point especificado.	DisplayObjectContainer
		close():void Cancela una operación de método load() que está actualmente en curso para la instancia de ProLoader.	ProLoader
		contains(child:DisplayObject):Boolean Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia.	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean Distribuye un evento en el flujo del evento.	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace.	DisplayObject
		getChildAt(index:int):DisplayObject Devuelve la instancia del objeto de visualización secundario que sale del índice especificado.	DisplayObjectContainer
		getChildByName(name:String):DisplayObject Devuelve el objeto de visualización secundario que sale con el nombre especificado.	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int Devuelve la posición de índice de una instancia secundaria de DisplayObject.	DisplayObjectContainer
		getObjectsUnderPoint(point:Point):Array Devuelve un conjunto de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer.	DisplayObjectContainer
		getRect(targetCoordinateSpace:DisplayObject):Rectangle Devuelve un rectángulo que define el límite del objeto de visualización, basado en el sistema de coordenadas definido por el parámetro targetCoordinateSpace, excluyendo los trazos en las formas.	DisplayObject
		globalToLocal(point:Point):Point Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).	DisplayObject
		globalToLocal3D(point:Point):Vector3D Convierte un punto bidimensional de las coordenadas (globales) del escenario en coordenadas (locales) de un objeto tridimensional.	DisplayObject
		hasEventListener(type:String):Boolean Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		hitTestObject(obj:DisplayObject):Boolean Calcula el cuadro delimitador del objeto de visualización para ver si se solapa o corta con el cuadro delimitador del objeto de visualización obj.	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el punto especificado por los parámetros x e y.	DisplayObject
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		load(request:URLRequest, context:LoaderContext = null):void Carga un archivo SWF, JPEG, JPEG progresivo, GIF sin animar o PNG en un objeto que es un elemento secundario de este objeto ProLoader.	ProLoader
		loadBytes(bytes:ByteArray, context:LoaderContext = null):void Se carga a partir de datos binarios almacenados en un objeto ByteArray.	ProLoader
		loadFilePromise(promise:Object, context:LoaderContext = null):void Carga una instancia de IFilePromise a través del parámetro promise.	ProLoader
		local3DToGlobal(point3d:Vector3D):Point Convierte un punto tridimensional de las coordenadas (locales) del objeto de visualización tridimensional en un punto bidimensional en las coordenadas (globales) del escenario.	DisplayObject
		localToGlobal(point:Point):Point Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).	DisplayObject
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		removeChild(child:DisplayObject):DisplayObject Elimina la instancia child de DisplayObject especificada de la lista de elementos secundarios de la instancia de DisplayObjectContainer.	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject Elimina una instancia de DisplayObject secundaria de la posición de índice especificada en la lista de elementos secundarios de DisplayObjectContainer.	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void Elimina todas las instancias child de DisplayObject especificadas de la lista de elementos secundarios de la instancia de DisplayObjectContainer.	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		requestSoftKeyboard():Boolean Muestra un teclado virtual.	InteractiveObject
		setChildIndex(child:DisplayObject, index:int):void Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización.	DisplayObjectContainer
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Permite al usuario arrastrar el elemento sprite especificado.	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void Permite al usuario arrastrar el elemento sprite especificado en un dispositivo táctil.	Sprite
		stopAllMovieClips():void Se detiene gradualmente la ejecución de línea de tiempo de todos los objetos MovieClip con raíz en este objeto.	DisplayObjectContainer
		stopDrag():void Finaliza el método startDrag().	Sprite
		stopTouchDrag(touchPointID:int):void Finaliza el método startTouchDrag() para su uso con dispositivos táctiles.	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void Intercambia el orden z (de delante a atrás) de los dos objetos secundarios especificados.	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void Intercambia el orden z (de delante a atrás) de los objetos secundarios situados en las posiciones de índice especificadas en la lista de elementos secundarios.	DisplayObjectContainer
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		unload():void Elimina un elemento secundario del objeto ProLoader que se cargó utilizando el método load().	ProLoader
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object
		willTrigger(type:String):Boolean 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

Haga clic para obtener más información sobre los eventos

Ocultar eventos heredados

Mostrar eventos heredados

	Resumen	Definido por
activate	[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.	EventDispatcher
added	Se distribuye cuando un objeto de visualización se añade a la lista de visualización.	DisplayObject
addedToStage	Se distribuye cuando un objeto de visualización se añade a la lista de visualización del escenario, bien directamente o a través de un subárbol que contiene el objeto de visualización.	DisplayObject
clear	Se distribuye cuando el usuario selecciona 'Borrar' (o 'Eliminar') en el menú contextual.	InteractiveObject
click	Se distribuye cuando un usuario pulsa y suelta el botón principal del dispositivo de señalización sobre el mismo objeto InteractiveObject.	InteractiveObject
contextMenu	Se distribuye cuando un gesto de usuario activa el menú contextual asociado al objeto interactivo la aplicación de AIR.	InteractiveObject
copy	Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para copiar elementos, o bien cuando el usuario elige la opción 'Copiar' en el menú contextual.	InteractiveObject
cut	Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para cortar elementos, o bien cuando el usuario elige la opción 'Cortar' en el menú contextual.	InteractiveObject
deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher
doubleClick	Se distribuye cuando un usuario pulsa y suelta el botón principal de un dispositivo de señalización dos veces en una sucesión rápida sobre el mismo objeto InteractiveObject cuando el indicador doubleClickEnabled de dicho objeto se ha definido como true.	InteractiveObject
enterFrame	[evento de difusión] Se distribuye cuando la cabeza lectora entra en un nuevo fotograma.	DisplayObject
exitFrame	[evento de difusión] Se distribuye cuando la cabeza lectora sale del fotograma actual.	DisplayObject
focusIn	Se distribuye después de que un objeto de visualización quede seleccionado.	InteractiveObject
focusOut	Se distribuye después de que un objeto de visualización deje de estar seleccionado.	InteractiveObject
frameConstructed	[evento de difusión] Se distribuye una vez ejecutados los constructores de los objetos de visualización del fotograma, pero antes de que se ejecuten los scripts de fotograma.	DisplayObject
gestureDirectionalTap	Se distribuye cuando el usuario crea un punto de contacto a lo largo del borde de la superficie de toque con una instancia de InteractiveObject (por ejemplo, toque a lo largo del borde de la superficie de toque en el servidor de Siri para Apple TV). Algunos dispositivos también pueden interpretar este contacto como una combinación de varios eventos táctiles.	InteractiveObject
gestureLongPress	Se distribuye cuando el usuario presiona dos puntos de contacto en la misma instancia de InteractiveObject en un dispositivo táctil (como, por ejemplo, pulsar y soltar dos dedos sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
gesturePan	Se distribuye cuando el usuario mueve un punto de contacto sobre la instancia de InteractiveObject de un dispositivo táctil (como mover los dedos de izquierda a derecha sobre un objeto de visualización en un teléfono móvil o dispositivo con pantalla táctil).	InteractiveObject
gestureRotate	Se distribuye cuando el usuario realiza un gesto de zoom en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con dos dedos y girarlos sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
gestureSwipe	Se distribuye cuando el usuario realiza un gesto de barrido en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con tres dedos y, a continuación, moverlos en paralelo sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
gestureTap	Se distribuye cuando el usuario crea un punto de contacto con una instancia de InteractiveObject, seguidamente toca un dispositivo táctil (como colocar varios dedos sobre un objeto de visualización para abrir un menú y, a continuación, toca con un dedo para seleccionar un elemento de menú en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
gestureZoom	Se distribuye cuando el usuario realiza un gesto de zoom en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con dos dedos y, a continuación, separarlos rápidamente sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
imeStartComposition	Este evento se distribuye a cualquier cliente app que admite entrada en línea con un IME	InteractiveObject
keyDown	Se distribuye cuando el usuario pulsa una tecla.	InteractiveObject
keyFocusChange	Se distribuye cuando el usuario intenta cambiar la selección empleando la navegación mediante teclado.	InteractiveObject
keyUp	Se distribuye cuando el usuario suelta una tecla.	InteractiveObject
middleClick	Se distribuye cuando un usuario pulsa y suelta el botón central del dispositivo de señalización sobre el mismo objeto InteractiveObject.	InteractiveObject
middleMouseDown	Se distribuye cuando el usuario pulsa el botón central del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
middleMouseUp	Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
mouseDown	Se distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
mouseFocusChange	Se distribuye cuando el usuario intenta cambiar la selección empleando un dispositivo de señalización.	InteractiveObject
mouseMove	Se distribuye cuando el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject.	InteractiveObject
mouseOut	Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.	InteractiveObject
mouseOver	Se distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject.	InteractiveObject
mouseUp	Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
mouseWheel	Se distribuye cuando se presiona la rueda del ratón sobre una instancia de InteractiveObject.	InteractiveObject
nativeDragComplete	Distribuido por el objeto InteractiveObject iniciador de arrastre cuando el usuario suelta el botón y finaliza el arrastre.	InteractiveObject
nativeDragDrop	Distribuido por el objeto InteractiveObject de destino cuando un objeto arrastrado se coloca sobre el objeto y la colocación se acepta con una llamada a DragManager.acceptDragDrop().	InteractiveObject
nativeDragEnter	Distribuido por un objeto InteractiveObject cuando la acción de arrastre entra en sus límites.	InteractiveObject
nativeDragExit	Distribuido por un objeto InteractiveObject cuando la acción de arrastre se sale de los límites.	InteractiveObject
nativeDragOver	Distribuido continuamente por un objeto InteractiveObject mientras la operación de arrastre se mantiene dentro de sus límites.	InteractiveObject
nativeDragStart	Distribuido al comienzo de una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag().	InteractiveObject
nativeDragUpdate	Distribuido durante una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag().	InteractiveObject
paste	Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para pegar elementos, o bien cuando el usuario elige la opción 'Pegar' en el menú contextual.	InteractiveObject
proximityBegin	Se distribuye cuando el usuario baja un lápiz stylus activo más allá del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityEnd	Se distribuye cuando el usuario levanta un lápiz stylus activo por encima del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityMove	Se distribuye cuando el usuario pasa un lápiz stylus activo por encima de la pantalla sin salir del umbral de detección de proximidad.	InteractiveObject
proximityOut	Se distribuye cuando el usuario quita un lápiz stylus activo de encima de este objeto InteractiveObject permaneciendo dentro del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityOver	Se distribuye cuando el usuario pasa un lápiz stylus activo directamente por encima de este objeto InteractiveObject permaneciendo dentro del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityRollOut	Se distribuye cuando el usuario quita un lápiz stylus activo de encima de este objeto InteractiveObject y sus elementos secundarios permaneciendo dentro del umbral de detección de proximidad de la pantalla.	InteractiveObject
proximityRollOver	Se distribuye cuando el usuario pasa un lápiz stylus activo por encima de este objeto InteractiveObject desde fuera del árbol de descendientes del objeto en la lista de visualización (permaneciendo dentro del umbral de detección de proximidad de la pantalla).	InteractiveObject
releaseOutside	Se distribuye cuando el usuario suelta el botón del dispositivo señalador por primera vez después de que el usuario presiona el botón sobre una instancia de InteractiveObject y, a continuación, mueve el dispositivo de señalización fuera de la instancia de InteractiveObject.	InteractiveObject
removed	Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización.	DisplayObject
removedFromStage	Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización, bien directamente o a través de la eliminación de un subárbol que contiene el objeto de visualización.	DisplayObject
render	[evento de difusión] Se distribuye cuando la lista de visualización se va a actualizar y representar.	DisplayObject
rightClick	Se distribuye cuando un usuario pulsa y suelta el botón derecho del dispositivo de señalización sobre el mismo objeto InteractiveObject.	InteractiveObject
rightMouseDown	Se distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
rightMouseUp	Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.	InteractiveObject
rollOut	Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject.	InteractiveObject
rollOver	Se distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject.	InteractiveObject
selectAll	Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para seleccionar todos los elementos, o bien cuando el usuario elige la opción 'Seleccionar todo' en el menú contextual.	InteractiveObject
softKeyboardActivate	Se distribuye inmediatamente una vez mostrado el teclado en pantalla.	InteractiveObject
softKeyboardActivating	Se distribuye inmediatamente antes de que se muestre el teclado en pantalla.	InteractiveObject
softKeyboardDeactivate	Se distribuye inmediatamente una vez oculto el teclado en pantalla.	InteractiveObject
tabChildrenChange	Se distribuye cuando cambia el valor del indicador tabChildren del objeto.	InteractiveObject
tabEnabledChange	Se distribuye cuando cambia el indicador tabEnabled del objeto.	InteractiveObject
tabIndexChange	Se distribuye cuando cambia el valor de la propiedad tabIndex del objeto.	InteractiveObject
textInput	Se distribuye cuando un usuario escribe uno o varios caracteres de texto.	InteractiveObject
touchBegin	Se distribuye cuando el usuario toca por primera vez un dispositivo táctil (por ejemplo, toca un teléfono móvil o dispositivo con pantalla táctil con un dedo).	InteractiveObject
touchEnd	Se distribuye cuando el usuario elimina el contacto con un dispositivo táctil (como levantar un dedo de un teléfono móvil o dispositivo con pantalla táctil).	InteractiveObject
touchMove	Se distribuye cuando el usuario toca el dispositivo y se distribuye constantemente hasta que desaparece el punto de contacto.	InteractiveObject
touchOut	Se distribuye cuando el usuario retira el punto de contacto de una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un objeto de visualización a otro en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
touchOver	Se distribuye cuando el usuario mueve el punto de contacto sobre una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un punto fuera de un objeto de visualización en un punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
touchRollOut	Se distribuye cuando el usuario retira el punto de contacto de una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un objeto de visualización a un punto fuera del objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
touchRollOver	Se distribuye cuando el usuario mueve el punto de contacto sobre una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un punto fuera de un objeto de visualización en un punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject
touchTap	Se distribuye cuando el usuario levanta el punto de contacto en la misma instancia de InteractiveObject en la que se inició el contacto en un dispositivo táctil (como, por ejemplo, pulsar y soltar un dedo desde un único punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil).	InteractiveObject

Información sobre propiedades

content

propiedad

content:DisplayObject [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS5.5

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9

Contiene el objeto de visualización raíz del archivo SWF o el archivo de imagen (JPG, PNG o GIF) que se cargó empleando los métodos load() o loadBytes().

Implementación
public function get content():DisplayObject

Emite

SecurityError — El archivo SWF cargado o el archivo de imagen pertenece a un entorno limitado de seguridad al que no tiene acceso. En el caso de un archivo SWF cargado, puede evitar esta situación haciendo que el archivo llame al método Security.allowDomain() o que el archivo que se carga especifique un parámetro loaderContext con la propiedad securityDomain configurada como SecurityDomain.currentDomain al llamar al método load() o loadBytes().

contentLoaderInfo

propiedad

contentLoaderInfo:ProLoaderInfo [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS5.5

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9

Devuelve un objeto ProLoaderInfo que corresponde al objeto que se está cargando. Los objetos ProLoaderInfo se comparten entre el objeto ProLoader y el objeto de contenido cargado. El objeto ProLoaderInfo proporciona información de progreso de carga y estadísticas sobre el archivo cargado.

Los eventos relacionados con la carga se distribuyen mediante el objeto ProLoaderInfo al que hace referencia la propiedad contentLoaderInfo del objeto ProLoader. La propiedad contentLoaderInfo se establece como un objeto ProLoaderInfo válido, antes incluso de que se cargue el contenido, de modo que se puedan añadir detectores de eventos al objeto antes de la carga.

Para detectar errores no capturados producidos en un archivo SWF cargado, utilice la propiedad ProLoader.uncaughtErrorEvents, no la propiedad ProLoader.contentLoaderInfo.uncaughtErrorEvents.

Nota La propiedad contentLoaderInfo devuelve un objeto ProLoaderInfo. ProLoaderInfo no es una subclase de LoaderInfo y, por lo tanto, no ofrece las ventajas de una copia implícita en la superclase. Por ello, asegúrese de cambiar su declaraciones type de LoaderInfo a ProLoaderInfo.

Implementación
public function get contentLoaderInfo():ProLoaderInfo

uncaughtErrorEvents

propiedad

uncaughtErrorEvents:EventDispatcher [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS5.5

Versiones de motor de ejecución:

Flash Player 10.1, AIR 2.0

Un objeto que distribuye un evento uncaughtError cuando se produce un error no gestionado en el código de este objeto ProLoader del archivo SWF. Un error sin capturar se produce cuando se emite un error fuera de los bloques try..catch o cuando un objeto ErrorEvent se distribuye sin ningún detector registrado.

Esta propiedad se crea cuando el archivo SWF asociado a este objeto ha terminado de cargarse. Hasta entonces, la propiedad uncaughtErrorEvents es null. En un proyecto sólo de ActionScript, puede acceder a esta propiedad durante o después de la ejecución de la función del constructor de la clase principal del archivo SWF.

Acceder a esta propiedad ProLoader en un reproductor que no admita, producirá un error. Devuelve un objeto EventDispatcher en lugar de un objeto UncaughtErrorEvents para evitar generar errores en reproductores no compatibles.

Implementación
public function get uncaughtErrorEvents():EventDispatcher

Elementos de API relacionados

flash.display.LoaderInfo.uncaughtErrorEvents

Información sobre constructores

()

Información sobre

public function ProLoader()

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS5.5

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9

Crea un objeto ProLoader que puede utilizar para cargar archivos como, por ejemplo, archivos SWF, JPEG, GIF o PNG. Llame al método load() para cargar el activo como elemento secundario de la instancia de ProLoader. Posteriormente, puede añadir el objeto ProLoader a la lista de visualización (por ejemplo, empleando el método addChild() de una instancia de DisplayObjectContainer). El activo aparece en el escenario conforme se va cargando.

También puede utilizar una instancia "offlist" (fuera de lista) de ProLoader, es decir, sin añadirla a un contenedor de objeto de visualización de la lista de visualización. En este modo, la instancia de Loader podría utilizarse para cargar un archivo SWF que contuviera módulos adicionales de una aplicación.

Para detectar cuándo termina de cargarse el archivo SWF, puede utilizar los eventos del objeto ProLoaderInfo asociado a la propiedad contentLoaderInfo del objeto ProLoader. Al llegar a ese punto, puede ejecutarse el código del archivo SWF de módulo para inicializar e iniciar el módulo. En el modo offlist (fuera de lista), una instancia de ProLoader podría utilizarse para cargar un archivo SWF que contuviera componentes o elementos multimedia adicionales. Una vez más, puede utilizar las notificaciones de eventos de objeto ProLoaderInfo para detectar cuándo terminan de cargarse los componentes. Al llegar a este punto, la aplicación puede comenzar a utilizar los componentes y elementos multimedia de la biblioteca del archivo SWF mediante la creación de instancias de las clases de ActionScript 3.0 que representan a dichos componentes y elementos.

Para determinar el estado de un objeto ProLoader, controle los siguientes eventos del objeto ProLoaderInfo asociado a la propiedad contentLoaderInfo del objeto ProLoader:

El evento open se distribuye cuando comienza la carga.
El evento ioError o securityError se distribuye si el archivo no se puede cargar o si se produce un error durante el proceso de carga.
El evento progress se activa continuamente mientras se está cargando el archivo.
El evento complete se distribuye cuando finaliza la descarga de un archivo, pero antes de que estén disponibles los métodos y propiedades del clip de película cargado. Si el archivo SWF cargado utiliza precarga RSL, este evento se distribuye después de que finalice la precarga RSL. En este punto, el contenido real está disponible en la propiedad content.
El evento init se distribuye una vez que estén accesibles las propiedades y los métodos del archivo SWF cargado, de manera que pueda comenzar a manipular el archivo SWF cargado. Se distribuye este evento antes que el controlador complete. Al transmitir mediante flujo archivos SWF, el evento init puede tener lugar bastante antes que el evento complete. En la mayoría de los casos, utilice el controlador init. Si el archivo SWF cargado utiliza precarga RSL, este evento se distribuye después de que finalice la precarga RSL. En este punto, el contenido real está disponible en la propiedad content.

Elementos de API relacionados

fl.display.ProLoader.load()
fl.display.ProLoaderInfo

Información sobre métodos

close

()

método

public function close():void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS5.5

Versiones de motor de ejecución:

AIR 1.0, Flash Player Player - 9

Cancela una operación de método load() que está actualmente en curso para la instancia de ProLoader.

load

()

método

public function load(request:URLRequest, context:LoaderContext = null):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS5.5

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Player Player - 9

Carga un archivo SWF, JPEG, JPEG progresivo, GIF sin animar o PNG en un objeto que es un elemento secundario de este objeto ProLoader. Si carga un archivo GIF animado, sólo aparece el primer fotograma. Dado que el objeto ProLoader sólo puede contener un único elemento secundario, la emisión de una petición load() posteriormente pone fin a la petición anterior, si ésta continúa pendiente, y comienza una nueva carga.

Nota: en AIR 1.5 y en Flash Player 10, el tamaño máximo de una imagen cargada es 8,191 píxeles de ancho o de largo, y el número total máximo de píxeles es 16.777.215. (De modo que si una imagen cargada tiene una anchura de 8.191 píxeles, sólo puede tener 2.048 píxeles de alto.) En Flash Player 9 y versiones anteriores y en AIR 1.1 y versiones anteriores, el límite es 2.880 píxeles de alto y 2.880 píxeles de ancho.

Un archivo SWF o imagen cargada en un objeto ProLoader hereda las propiedades de posición, giro y escala de los objetos de visualización principales del objeto ProLoader.

Utilice el método unload() para eliminar películas o imágenes cargadas con este método o cancelar una operación de carga que se encuentra en curso.

Asimismo, se puede impedir que un archivo SWF utilice este método si define el parámetro allowNetworking de las etiquetas object y embed de la página HTML que aloja el contenido SWF.

Cuando utilice este método, considere el modelo de seguridad de Flash Player (consulte la descripción de la clase ProLoader).

En Flash Player 10 y versiones posteriores, si utiliza una estructura Content-Type de varias partes (por ejemplo, "multipart/form-data") con una acción de carga (indicada por un parámetro "filename" en un encabezado "content-disposition" dentro del cuerpo POST), la operación POST está sujeta a las reglas de seguridad aplicadas a las cargas:

Es preciso realizar una operación POST como respuesta a una acción iniciada por el usuario, por ejemplo, un clic de ratón o la pulsación de una tecla.
Si la operación POST afecta a varios dominios (el destino POST no se encuentra en el mismo servidor que el archivo SWF que envía la petición POST), el servidor de destino debe proporcionar un archivo de política URL que permita el acceso a varios dominios.

Asimismo, en cualquier estructura Content-Type de varias partes, la sintaxis debe ser válida (de acuerdo con la norma RFC2046). Si la sintaxis no es válida, la operación POST está sujeta a las reglas de seguridad que se aplican a las cargas.

Para obtener más información, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

Parámetros

request:URLRequest — URL absoluta o relativa del archivo SWF, JPEG, GIF o PNG que va a cargarse. La ruta debe ser relativa al archivo SWF principal. Las URL absolutas incluyen la referencia al protocolo, como http:// o file:///. Los nombres de archivo no pueden incluir especificaciones de unidad de disco.

context:LoaderContext (default = null) — Un objeto LoaderContext que tiene propiedades que definen lo siguiente:

Si se debe o no comprobar la existencia de un archivo de política al cargar el objeto
El dominio ApplicationDomain del objeto cargado
El dominio SecurityDomain del objeto cargado
ImageDecodingPolicy para la imagen del objeto cargado

Si el parámetro context no se especifica o si hace referencia a un objeto null, el contenido cargado permanece en su propio dominio de seguridad.

Para obtener información completa, consulte la descripción de las propiedades de la clase LoaderContext.

Eventos

	`asyncError:AsyncErrorEvent` — Distribuido por el objeto `contentLoaderInfo` si la propiedad `LoaderContext.requestedContentParent` se ha especificado y no es posible añadir contenido cargado como un elemento secundario al objeto DisplayObjectContainer especificado. Esto podría suceder si el contenido cargado es un `flash.display.AVM1Movie` o si la llamada `addChild()` a requestedContentParent emite un error.

	`complete:Event` — Distribuido por el objeto `contentLoaderInfo` cuando el archivo ha terminado de cargarse. El evento `complete` siempre se distribuye después del evento `init`.

	`httpStatus:HTTPStatusEvent` — Distribuido por el objeto `contentLoaderInfo` cuando se realiza una petición de red a través de HTTP y Flash Player puede detectar el código de estado HTTP.

	`init:Event` — Distribuido por el objeto `contentLoaderInfo` cuando las propiedades y métodos del archivo SWF están accesibles. El evento `init` siempre precede al evento `complete`.

	`ioError:IOErrorEvent` — Distribuido por el objeto `contentLoaderInfo` cuando se produce un error de entrada o salida que provoca que una operación de carga se realice incorrectamente.

	`open:Event` — Distribuido por el objeto `contentLoaderInfo` cuando se inicia la operación de carga.

	`progress:ProgressEvent` — Distribuido por el objeto `contentLoaderInfo` al recibirse datos mientras progresa una operación de carga.

	`securityError:SecurityErrorEvent` — Distribuido por el objeto `contentLoaderInfo` si un archivo del entorno limitado local del sistema de archivos intenta cargar contenido en el entorno limitado local de red, o viceversa.

	`securityError:SecurityErrorEvent` — Distribuido por el objeto `contentLoaderInfo` si la propiedad `LoaderContext.requestedContentParent` se ha especificado y si el entorno limitado de seguridad de `LoaderContext.requestedContentParent` no tiene acceso al SWF cargado.

	`unload:Event` — Distribuido por el objeto `contentLoaderInfo` cuando se elimina un objeto cargado.

Emite

	`IOError` — La propiedad `digest` del objeto `request` no es `null`. Sólo debe establecerse la propiedad `digest` de un objeto URLRequest al llamar al método `URLLoader.load()` cuando se carga un archivo SWZ (componente de plataforma de Adobe).

	`SecurityError` — El valor de `LoaderContext.securityDomain` debe ser `null` o `SecurityDomain.currentDomain`. Esto refleja el hecho de que sólo puede colocar los medios cargados en su entorno limitado de seguridad natural o en el suyo propio (éste último requiere un archivo de política).

	`SecurityError` — Es posible que los archivos SWF no establezcan LoaderContext.securityDomain con ningún valor que no sea `null`. No se permite importar medios que no sean locales en un entorno limitado de seguridad local ni colocar otros medios locales en un lugar que no sea su entorno limitado de seguridad natural.

	`SecurityError` — No es posible conectar con puertos reservados comúnmente. Para obtener una lista completa de los puertos bloqueados, consulte la sección “Restricción de API de red” en el Guía del desarrollador de ActionScript 3.0.

	`SecurityError` — Si las propiedades `applicationDomain` o `securityDomain` del parámetro `context` proceden de un dominio no autorizado.

	`SecurityError` — Si un archivo SWF local está intentando utilizar la propiedad `securityDomain` del parámetro `context`.

	`IllegalOperationError` — Si la propiedad `requestedContentParent` del parámetro `context` es un objeto `ProLoader`.

	`IllegalOperationError` — Si el parámetro `LoaderContext.parameters` se establece en un valor que no sea null y tiene algunos valores que no son cadenas.

Elementos de API relacionados

contentLoaderInfo
flash.net.URLRequest
flash.display.DisplayObject
fl.display.ProLoader.unload()
fl.display.ProLoaderInfo
flash.system.LoaderContext

loadBytes

()

método

public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS5.5

Versiones de motor de ejecución:

Flash Player 9, AIR 1.0, Flash Player 9

Se carga a partir de datos binarios almacenados en un objeto ByteArray.

El método loadBytes() es asíncrono. Se debe esperar al evento "init" antes de acceder a las propiedades de un objeto cargado.

Cuando utilice este método, considere el modelo de seguridad de Flash Player (consulte la descripción de la clase ProLoader).

Parámetros

bytes:ByteArray — Un objeto ByteArray. El contenido de ByteArray puede tener cualquiera de los formatos de archivo admitidos por la clase ProLoader: SWF, GIF, JPEG o PNG.

context:LoaderContext (default = null) — Objeto LoaderContext. Sólo se aplica la propiedad applicationDomain del objeto LoaderContext; no se aplican las propiedades checkPolicyFile y securityDomain del objeto LoaderContext.

Si el parámetro context no se especifica o si hace referencia a un objeto null, el contenido se carga en el dominio de seguridad activo mediante un proceso denominado "carga de importación" y descrito en la documentación de seguridad de Flash Player. En concreto, si el archivo SWF de carga confía en el SWF remoto e incorpora el SWF remoto en su código, el contenido SWF puede importarlo directamente a su propio dominio de seguridad.

Para obtener más información, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

Eventos

	`asyncError:AsyncErrorEvent` — Distribuido por el objeto `contentLoaderInfo` si la propiedad `LoaderContext.requestedContentParent` se ha especificado y no es posible añadir contenido cargado como un elemento secundario al objeto DisplayObjectContainer especificado. Esto podría suceder si el contenido cargado es un `flash.display.AVM1Movie` o si la llamada `addChild()` a requestedContentParent emite un error.

	`complete:Event` — Distribuido por el objeto `contentLoaderInfo` cuando la operación ha finalizado. El evento `complete` siempre se distribuye después del evento `init`.

	`init:Event` — Distribuido por el objeto `contentLoaderInfo` cuando las propiedades y métodos de los datos cargados están accesibles. El evento `init` siempre precede al evento `complete`.

	`ioError:IOErrorEvent` — Distribuido por el objeto `contentLoaderInfo` cuando el motor de ejecución no puede analizar los datos del conjunto de bytes.

	`open:Event` — Distribuido por el objeto `contentLoaderInfo` cuando se inicia la operación.

	`progress:ProgressEvent` — Distribuido por el objeto `contentLoaderInfo` como datos transferidos a la memoria.

	`securityError:SecurityErrorEvent` — Distribuido por el objeto `contentLoaderInfo` si la propiedad `LoaderContext.requestedContentParent` se ha especificado y si el entorno limitado de seguridad de `LoaderContext.requestedContentParent` no tiene acceso al SWF cargado.

	`unload:Event` — Distribuido por el objeto `contentLoaderInfo` cuando se elimina un objeto cargado.

Emite

	`ArgumentError` — Si la propiedad `length` del objeto ByteArray no es mayor que 0.

	`IllegalOperationError` — Si las propiedades `checkPolicyFile` o `securityDomain` del parámetro `context` no tienen el valor null.

	`IllegalOperationError` — Si la propiedad `requestedContentParent` del parámetro `context` es un objeto `ProLoader`.

	`IllegalOperationError` — Si el parámetro `LoaderContext.parameters` se establece en un valor que no sea null y tiene algunos valores que no son cadenas.

	`SecurityError` — Si la propiedad `applicationDomain` proporcionada de la propiedad `context` procede de un dominio no autorizado.

	`SecurityError` — No es posible conectar con puertos reservados comúnmente. Para obtener una lista completa de los puertos bloqueados, consulte la sección “Restricción de API de red” en el Guía del desarrollador de ActionScript 3.0.

Elementos de API relacionados

flash.utils.ByteArray
flash.system.LoaderContext.applicationDomain

loadFilePromise

()

método

public function loadFilePromise(promise:Object, context:LoaderContext = null):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS5.5

Versiones de motor de ejecución:

AIR 2.5, AIR 2.0, Flash Player 9

Carga una instancia de IFilePromise a través del parámetro promise. El tipo del parámetro promise utiliza la superclase Object en lugar de IFilePromise para evitar errores en otros reproductores.

El método loadFilePromise toma un objeto IFilePromise y carga los datos binarios. Si los datos son un flujo progresivo, como una espera de vídeo para los eventos "init" o progress antes de acceder a las propiedades del objeto cargado. De lo contrario, espera al evento complete para asegurarse de que los datos se han cargado por completo.

Cuando utilice este método, considere el modelo de seguridad de Flash Player (consulte la descripción de la clase ProLoader).

Parámetros

promise:Object — Un objeto IFilePromise. El origen de datos del objeto puede tener cualquiera de los formatos de archivo admitidos por la clase ProLoader: SWF, GIF, JPEG o PNG.

Para obtener más información, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

Eventos

	`asyncError:AsyncErrorEvent` — Distribuido por el objeto `contentLoaderInfo` si la propiedad `LoaderContext.requestedContentParent` se ha especificado y no es posible añadir contenido cargado como un elemento secundario al objeto DisplayObjectContainer especificado. Esto podría suceder si el contenido cargado es un `flash.display.AVM1Movie` o si la llamada `addChild()` a requestedContentParent emite un error.

	`complete:Event` — Distribuido por el objeto `contentLoaderInfo` cuando la operación ha finalizado. El evento `complete` siempre se distribuye después del evento `init`.

	`init:Event` — Distribuido por el objeto `contentLoaderInfo` cuando las propiedades y métodos de los datos cargados están accesibles. El evento `init` siempre precede al evento `complete`.

	`ioError:IOErrorEvent` — Distribuido por el objeto `contentLoaderInfo` cuando el motor de ejecución no puede analizar los datos en el origen de datos o si el origen de datos flujo no se puede leer.

	`open:Event` — Distribuido por el objeto `contentLoaderInfo` cuando se inicia la operación.

	`progress:ProgressEvent` — Distribuido por el objeto `contentLoaderInfo` como datos transferidos a la memoria.

	`securityError:SecurityErrorEvent` — Distribuido por el objeto `contentLoaderInfo` si la propiedad `LoaderContext.requestedContentParent` se ha especificado y si el entorno limitado de seguridad de `LoaderContext.requestedContentParent` no tiene acceso al SWF cargado.

	`unload:Event` — Distribuido por el objeto `contentLoaderInfo` cuando se elimina un objeto cargado. Advertencia Acceder a esta API fuera de la aplicación AIR producirá un error.

Emite

	`IllegalOperationError` — Si la propiedad `requestedContentParent` del parámetro `context` es un objeto `ProLoader`.

	`IllegalOperationError` — Si el parámetro `LoaderContext.parameters` se establece en un valor que no sea null y tiene algunos valores que no son cadenas.

	`ArgumentError` — Si el objeto `IFilePromise` pasado como parámetro es null

Elementos de API relacionados

MediaPromise
CameraRoll.browseForImage()
CameraUI

unload

()

método

public function unload():void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS5.5

Versiones de motor de ejecución:

AIR 1.0, Flash Player 9

Elimina un elemento secundario del objeto ProLoader que se cargó utilizando el método load(). El elemento property del objeto ProLoaderInfo asociado se restablece con el valor null. El elemento secundario no se destruye necesariamente, ya que otros objetos pueden contener referencias a él; sin embargo, deja de ser elemento secundario del objeto ProLoader.

La práctica más recomendable consiste en cerrar explícitamente los flujos de los objetos de un archivo SWF secundario como, por ejemplo, los objetos LocalConnection, NetConnection, NetStream y Sound, antes de descargar dicho archivo SWF secundario. En caso contrario, podría continuar reproduciéndose el sonido del archivo SWF secundario aunque se hubiera descargado el archivo SWF secundario. Para cerrar los flujos del archivo SWF secundario, añada un detector de eventos al elemento secundario que detecte el evento unload. Cuando el elemento principal llame a ProLoader.unload(), se distribuirá el evento unload al elemento secundario. En el ejemplo siguiente, se muestra cómo puede lograr esto:

function closeAllStreams(evt:Event) { 
    myNetStream.close();
    mySound.close();
    myNetConnection.close();
    myLocalConnection.close();
}

myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

Elementos de API relacionados

fl.display.ProLoader.load()
flash.media.Sound.close()
flash.net.LocalConnection.close()
flash.net.NetConnection.close()
flash.net.NetStream.close()
delete, operador

Avisos legales | Política de privacidad en línea

ProLoader - AS3 Flash

Clases x

content

contentLoaderInfo

uncaughtErrorEvents

ProLoader

close

load

loadBytes

loadFilePromise

unload