fl.containers.UILoader (ActionScript 3.0)

	Propiedad	Definido por
		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
		autoLoad : Boolean Obtiene o define un valor que indica si la instancia UILoader carga de forma automática el contenido especificado.	UILoader
		blendMode : String Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse.	DisplayObject
		buttonMode : Boolean Especifica el modo de botón de este elemento sprite.	Sprite
		bytesLoaded : uint [read-only] Obtiene el recuento de bytes de contenido que se han cargado.	UILoader
		bytesTotal : uint [read-only] Obtiene el recuento de bytes del contenido que se va a cargar.	UILoader
		cacheAsBitmap : Boolean Si se define como true, Flash Player deja en caché una representación interna de mapa de bits del objeto de visualización.	DisplayObject
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		content : DisplayObject [read-only] Contiene el objeto de visualización raíz del archivo SWF o de imagen (archivo de formato JPG, PNG o GIF) que se cargó mediante el método load() o definiendo la propiedad source.	UILoader
		contextMenu : ContextMenu Especifica el menú contextual asociado a este objeto.	InteractiveObject
		doubleClickEnabled : Boolean Especifica si este objeto recibe eventos doubleClick.	InteractiveObject
		dropTarget : DisplayObject [read-only] 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
		enabled : Boolean Obtiene o define un valor que indica si el componente puede aceptar la interacción del usuario.	UIComponent
		filters : Array Matriz indexada que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización.	DisplayObject
		focusEnabled : Boolean Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él.	UIComponent
		focusManager : IFocusManager Obtiene o define la clase FocusManager que controla la selección de este componente y sus homólogos.	UIComponent
		focusRect : Object Especifica si este objeto muestra un rectángulo de selección.	InteractiveObject
		graphics : Graphics [read-only] Especifica el objeto Graphics que pertenece a este elemento sprite, donde pueden ejecutarse comandos de dibujo vectorial.	Sprite
		height : Number Obtiene o define la altura del componente, expresada en píxeles.	UIComponent
		hitArea : Sprite Designa otro elemento sprite para que actúe como área activa de un elemento sprite.	Sprite
		loaderInfo : LoaderInfo [read-only] Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización.	DisplayObject
		maintainAspectRatio : Boolean Obtiene o define un valor que indica si se va a mantener la proporción que se utilizó en la imagen original o se va a cambiar el tamaño de la imagen a la anchura y altura actual del componente UILoader.	UILoader
		mask : DisplayObject El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado.	DisplayObject
		mouseChildren : Boolean Determina si los elementos secundarios del objeto están habilitados para ratón.	DisplayObjectContainer
		mouseEnabled : Boolean Especifica si este objeto recibe mensajes de ratón.	InteractiveObject
		mouseFocusEnabled : Boolean Obtiene o define un valor booleano que indica si el componente puede recibir selecciones cuando el usuario hace clic sobre él.	UIComponent
		mouseX : Number [read-only] Indica la coordenada x de la posición del ratón en píxeles.	DisplayObject
		mouseY : Number [read-only] Indica la coordenada y de la posición del ratón en píxeles.	DisplayObject
		name : String Indica el nombre de instancia de DisplayObject.	DisplayObject
		numChildren : int [read-only] 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 [read-only] Indica el objeto DisplayObjectContainer que contiene este objeto de visualización.	DisplayObject
		percentLoaded : Number [read-only] Obtiene un número entre 0 y 100 que indica el porcentaje del contenido cargado.	UILoader
		prototype : Object [static] Una referencia al objeto prototipo de una clase u objeto de función.	Object
		root : DisplayObject [read-only] 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
		scale9Grid : Rectangle La cuadrícula de escala aplicada actualmente.	DisplayObject
		scaleContent : Boolean Obtiene o define un valor que indica si se va a ampliar automáticamente la imagen al tamaño de la instancia de UILoader.	UILoader
		scaleX : Number Multiplica la anchura actual del componente por un factor de escala.	UIComponent
		scaleY : Number Multiplica la altura actual del componente por un factor de escala.	UIComponent
		scrollRect : Rectangle Los límites del rectángulo de desplazamiento del objeto de visualización.	DisplayObject
		soundTransform : SoundTransform Controla el sonido dentro de este elemento sprite.	Sprite
		source : Object Obtiene o define una dirección URL absoluta o relativa que identifica la ubicación del archivo SWF o un archivo de imagen para cargar, o bien el nombre de clase de un clip de película en la biblioteca, una referencia a un objeto de visualización, o un nombre de instancia de un clip de película en el mismo nivel que el componente.	UILoader
		stage : Stage [read-only] 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 : TextSnapshot [read-only] Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.	DisplayObjectContainer
		transform : 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
		useHandCursor : Boolean Valor booleano que indica si debe aparecer la mano que señala (cursor de mano) cuando el ratón pasa por encima de un elemento sprite en el que la propiedad buttonMode se ha definido con el valor true.	Sprite
		version : String = "3.0.0.15" Número de versión de los componentes.	UIComponent
		visible : Boolean Obtiene o define un valor que indica si la instancia del componente actual es visible.	UIComponent
		width : Number Obtiene o define la anchura del componente, expresada en píxeles.	UIComponent
		x : Number Obtiene o define la coordenada x que representa la posición del componente a lo largo del eje x en su contenedor principal.	UIComponent
		y : Number Obtiene o define la coordenada y que representa la posición del componente a lo largo del eje y en su contenedor principal.	UIComponent

	Método	Definido por
		UILoader() Crea una nueva instancia del componente UILoader.	UILoader
		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
		clearStyle(style:String):void Elimina una propiedad de estilo de esta instancia de componente.	UIComponent
		close():void Cancela una operación de método load() que está actualmente en curso para la instancia de Loader.	UILoader
		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
		drawFocus(focused:Boolean):void Muestra u oculta el indicador de selección en este componente.	UIComponent
		drawNow():void Inicia de forma inmediata una operación de dibujo, sin invalidarlo todo como ocurre con invalidateNow.	UIComponent
		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
		getFocus():InteractiveObject Recupera el objeto que está seleccionado actualmente.	UIComponent
		getObjectsUnderPoint(point:Point):Array Devuelve una matriz 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
		getStyle(style:String):Object Recupera una propiedad de estilo que se define en la cadena de búsqueda de estilo del componente.	UIComponent
		getStyleDefinition():Object [static] Devuelve la asignación de estilos predeterminada del componente actual.	UILoader
		globalToLocal(point:Point):Point Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales).	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 Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el 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
		invalidate(property:String, callLater:Boolean = true):void Marca una propiedad como no válida y vuelve a dibujar el componente en el siguiente fotograma a menos que se especifique lo contrario.	UIComponent
		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 = null, context:LoaderContext = null):void Carga el contenido especificado o, en caso de que no se haya especificado, carga el contenido de la ubicación identificada por la propiedad source.	UILoader
		loadBytes(bytes:ByteArray, context:LoaderContext = null):void Se carga a partir de datos binarios almacenados en un objeto ByteArray.	UILoader
		localToGlobal(point:Point):Point Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales).	DisplayObject
		mergeStyles(... list):Object [static] Combina los estilos de varias clases en un objeto.	UIComponent
		move(x:Number, y:Number):void Mueve el componente a la posición especificada dentro de su elemento principal.	UIComponent
		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
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		setChildIndex(child:DisplayObject, index:int):void Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización.	DisplayObjectContainer
		setFocus():void Selecciona este componente.	UIComponent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		setSize(w:Number, h:Number):void Cambia el tamaño del componente al indicado.	UILoader
		setStyle(style:String, value:Object):void Define una propiedad de estilo en esta instancia de componente.	UIComponent
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Permite al usuario arrastrar el elemento sprite especificado.	Sprite
		stopDrag():void Finaliza el método startDrag().	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
		toString():String Devuelve la representación de cadena del objeto especificado.	Object
		unload():void Quita un elemento secundario del objeto UILoader que se cargó utilizando el método load() o la propiedad source.	UILoader
		validateNow():void Valida y actualiza las propiedades y el diseño de este objeto y lo vuelve a dibujar, si es necesario.	UIComponent
		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

Resumen	Definido por
activate	Se distribuye cuando Flash Player queda seleccionado por el sistema operativo y pasa a estar activo.	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
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
complete	Se distribuye cuando se ha completado la carga del contenido.	UILoader
deactivate	Se distribuye cuando Flash Player deja de estar seleccionado por el sistema operativo y pasa a estar inactivo.	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	Se distribuye cuando la cabeza lectora entra en un nuevo fotograma.	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
hide	Se distribuye cuando la visibilidad del componente cambia de visible a invisible.	UIComponent
init	Se distribuye cuando las propiedades y métodos de un archivo SWF cargado están accesibles.	UILoader
ioError	Se distribuye después de que se produzca un error de entrada/salida.	UILoader
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
mouseDown	Se distribuye cuando el usuario pulsa el botón del dispositivo de señalización sobre una instancia de InteractiveObject en la ventana de Flash Player.	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 pasa el dispositivo de señalización por encima de una instancia de InteractiveObject en la ventana de Flash Player.	InteractiveObject
mouseUp	Se distribuye cuando el usuario suelta el botón del dispositivo de señalización sobre una instancia de InteractiveObject en la ventana de Flash Player.	InteractiveObject
mouseWheel	Se distribuye cuando se hace girar una rueda de ratón sobre una instancia de InteractiveObject en la ventana de Flash Player.	InteractiveObject
move	Se distribuye cuando se mueve el componente.	UIComponent
open	Se distribuye cuando se inicia una operación de red.	UILoader
progress	Se distribuye cuando se está cargando el contenido.	UILoader
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	Se distribuye cuando la lista de visualización se va a actualizar y mostrar.	DisplayObject
resize	Se distribuye cuando se cambia el tamaño del componente.	UILoader
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
securityError	Se distribuye cuando se produce un error de seguridad mientras se está cargando el contenido.	UILoader
show	Se distribuye cuando la visibilidad del componente cambia de invisible a visible.	UIComponent
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

Descripción	Definido por
disabledTextFormat	Tipo: flash.text.TextFormat El objeto TextFormat que se utilizará para representar la etiqueta del componente cuando el botón esté desactivado.	UIComponent
focusRectPadding	Tipo: Number Formato: Length El relleno que separa los límites externos del componente de los bordes externos del indicador de selección, expresado en píxeles.	UIComponent
focusRectSkin	Tipo: Class El aspecto que se utilizará para mostrar los indicadores de selección.	UIComponent
textFormat	Tipo: flash.text.TextFormat El objeto TextFormat que se utilizará para representar la etiqueta del componente.	UIComponent

Información sobre propiedades

autoLoad

propiedad

autoLoad:Boolean [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Obtiene o define un valor que indica si la instancia UILoader carga de forma automática el contenido especificado. El valor true indica que UILoader carga de forma automática el contenido; mientras que el valor false indica que el contenido no se ha cargado hasta que se llama al método load().

El valor predeterminado es true.

Implementación
public function get autoLoad():Boolean
public function set autoLoad(value:Boolean):void

Véase también

load()
source

Ejemplo

En el ejemplo siguiente, se muestra cómo al definir la propiedad autoLoad como false se evita que el contenido se cargue hasta que se llame al método load():


import fl.containers.UILoader;
import fl.controls.Button;

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myUILoader.move(10, 40);
addChild(myUILoader);

var myButton:Button = new Button();
myButton.label = "Load image";
myButton.move(10, 10);
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myButton);

function clickHandler(event:MouseEvent):void {
    myUILoader.load();
}

bytesLoaded

propiedad

bytesLoaded:uint [read-only]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Obtiene el recuento de bytes de contenido que se han cargado. Cuando esta propiedad iguala el valor de bytesTotal, todos los bytes están cargados.

El valor predeterminado es 0.

Implementación
public function get bytesLoaded():uint

Véase también

bytesTotal
percentLoaded

Ejemplo

En el ejemplo siguiente, se crea una instancia de componente UILoader que muestra una imagen cargada y una instancia de componente ProgressBar y Label que muestra el estado de descarga actual de la imagen:


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

bytesTotal

propiedad

bytesTotal:uint [read-only]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Obtiene el recuento de bytes del contenido que se va a cargar.

El valor predeterminado es 0.

Implementación
public function get bytesTotal():uint

Véase también

bytesLoaded
percentLoaded

Ejemplo


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

content

propiedad

content:DisplayObject [read-only]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Contiene el objeto de visualización raíz del archivo SWF o de imagen (archivo de formato JPEG, PNG o GIF) que se cargó mediante el método load() o al definir la propiedad source. El valor es undefined hasta que comienza la carga. Defina las propiedades para el contenido de una función de controlador de eventos del evento complete.

El valor predeterminado es null.

Implementación
public function get content():DisplayObject

Véase también

complete
load()
source

Ejemplo

En el ejemplo siguiente, se crea un deslizador que modifica la transparencia del contenido de un objeto UILoader:


import fl.controls.Slider;
import fl.containers.UILoader;
import fl.events.SliderEvent;

var s:Slider = new Slider();
s.minimum = 10;
s.maximum = 100;
s.liveDragging = true;
s.value = s.maximum;
s.move(10,10);
s.addEventListener(SliderEvent.THUMB_DRAG, updateUILoaderContentAlpha);
addChild(s);

var loader:UILoader = new UILoader();
loader.move(10,40);
loader.setSize(400, 300);
loader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(loader);

function updateUILoaderContentAlpha(e:SliderEvent):void {
    loader.content.alpha = s.value/100;
}

maintainAspectRatio

propiedad

maintainAspectRatio:Boolean [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Obtiene o define un valor que indica si se va a mantener la proporción que se utilizó en la imagen original o se va a cambiar el tamaño de la imagen a la anchura y altura actual del componente UILoader. Un valor true indica que se va a mantener la proporción original; mientras que un valor false indica que se debería cambiar el tamaño del contenido cargado a las dimensiones actuales de UILoader.

Para utilizar esta propiedad, defina la propiedad scaleContent como false. De lo contrario, se omitirá esta propiedad.

El valor predeterminado es true.

Implementación
public function get maintainAspectRatio():Boolean
public function set maintainAspectRatio(value:Boolean):void

Véase también

scaleContent

Ejemplo

En el ejemplo siguiente, se utiliza la casilla de verificación para activar el valor de la propiedad maintainAspectRatio:


import fl.containers.UILoader;
import fl.controls.CheckBox;

var myUILoader:UILoader = new UILoader();
myUILoader.setSize(200, 200);
myUILoader.scaleContent = true;
myUILoader.maintainAspectRatio = true;
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.move(10, 10);
addChild(myUILoader);

var myCheckBox:CheckBox = new CheckBox();
myCheckBox.label = "maintainAspectRatio";
myCheckBox.selected = myUILoader.maintainAspectRatio;
myCheckBox.width = 150;
myCheckBox.move(220, 10);
myCheckBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myCheckBox);

function changeHandler(event:Event):void {
    myUILoader.maintainAspectRatio = event.target.selected;
}

percentLoaded

propiedad

percentLoaded:Number [read-only]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Obtiene un número entre 0 y 100 que indica el porcentaje del contenido cargado. Si está cargando activos de la biblioteca, y no contenido cargado de forma externa, la propiedad percentLoaded se define como 0.

El valor predeterminado es 0.

Implementación
public function get percentLoaded():Number

Véase también

bytesLoaded
bytesTotal

Ejemplo


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

scaleContent

propiedad

scaleContent:Boolean [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Obtiene o define un valor que indica si se va a ampliar automáticamente la imagen al tamaño de la instancia de UILoader. Un valor true indica que la imagen se amplía automáticamente al tamaño de la instancia de UILoader; mientras que el valor false indica que el contenido cargado se ha ampliado automáticamente a su tamaño predeterminado.

El valor predeterminado es true.

Implementación
public function get scaleContent():Boolean
public function set scaleContent(value:Boolean):void

Véase también

maintainAspectRatio

Ejemplo

En el ejemplo siguiente, se crea un objeto UILoader que se carga y hace coincidir las dimensiones de una imagen:


import fl.containers.UILoader;

var loader:UILoader = new UILoader();
loader.scaleContent = false;
loader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(loader);

source

propiedad

source:Object [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Obtiene o define una dirección URL absoluta o relativa que identifica la ubicación del archivo SWF o un archivo de imagen para cargar, o bien el nombre de clase de un clip de película en la biblioteca, una referencia a un objeto de visualización, o un nombre de instancia de un clip de película en el mismo nivel que el componente.

Entre los formatos de archivo de imagen válidos se incluyen GIF, PNG y JPEG. Para cargar un activo mediante un objeto URLRequest, utilice el método load().

El valor predeterminado es null.

Implementación
public function get source():Object
public function set source(value:Object):void

Véase también

autoLoad
load()

Ejemplo

En el ejemplo siguiente, se crea un objeto UILoader que se carga y hace coincidir las dimensiones de una imagen:

import fl.containers.UILoader;

var loader:UILoader = new UILoader();
loader.scaleContent = false;
loader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(loader);

Información sobre constructores

UILoader

()

constructor

public function UILoader()

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Crea una nueva instancia del componente UILoader.

Información sobre métodos

()

método

public function close():void

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Cancela una operación de método load() que está actualmente en curso para la instancia de Loader. También se puede llamar al método load() desde el parámetro source.

Emite

Error — Este objeto URLStream no tiene ningún flujo abierto.

Véase también

load()
source

Ejemplo

En el ejemplo siguiente, se crea una instancia de componente UILoader y una instancia de componente Button que permiten cancelar la descarga de la imagen de la instancia de UILoader:


import fl.containers.UILoader;
import fl.controls.Button;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myUILoader.move(10, 30);
addChild(myUILoader);

var cancelButton:Button = new Button();
cancelButton.label = "Cancel download";
cancelButton.move(10, 10);
cancelButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(cancelButton);

function clickHandler(event:MouseEvent):void {
    var uil:UILoader = myUILoader;
    try {
        uil.close();
        trace("Download cancelled:", uil.source);
    } catch (error:Error) {
        trace("Unable to cancel download.", error.message);
    }
}

getStyleDefinition

()

método

public static function getStyleDefinition():Object

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Devuelve la asignación de estilos predeterminada del componente actual. La asignación de estilos contiene el tipo adecuado para el componente, en función del estilo que ese componente utilice. Por ejemplo, el estilo disabledTextFormat contiene un valor null o un objeto TextFormat. Puede utilizar estos estilos y llamar a setStyle() en el componente actual. El código siguiente sustituye el estilo predeterminado disabledTextFormat en el componente especificado:

componentInstance.setStyle("disabledTextFormat", new TextFormat());

Valor devuelto

Object — Objeto de estilos predeterminados.

Véase también

UIComponent.getStyle()
UIComponent.setStyle()
StyleManager

Ejemplo

En el ejemplo siguiente, se crea un navegador de estilos para varias clases de componentes:

import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}

load

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Carga el contenido especificado o, en caso de que no se haya especificado, carga el contenido de la ubicación identificada por la propiedad source. De forma predeterminada, el objeto LoaderContext utiliza el dominio actual como dominio de aplicación. Para especificar otro dominio de aplicación, buscar un archivo de política o cambiar el dominio de seguridad, inicialice un nuevo objeto LoaderContext y páselo a este método.

De forma predeterminada, la propiedad del contexto utiliza el dominio actual. Para especificar otra propiedad ApplicationDomain, busque un archivo de política o cambie la propiedad SecurityDomain, pase a un nuevo objeto LoaderContext.

Parámetros

	`request:URLRequest` (default = `null`) — El objeto URLRequest que identifica la ubicación desde la que se carga el contenido. Si no se especifica ningún valor, se utiliza el valor actual de la propiedad `source` como ubicación del contenido.

	`context:LoaderContext` (default = `null`) — El objeto LoaderContext que define el contexto de la operación de carga.

Véase también

autoLoad
close()
source
unload()
flash.system.ApplicationDomain
flash.system.LoaderContext

Ejemplo

En el ejemplo siguiente, se crea una nueva instancia de UILoader y se carga una imagen con el método load() con la propiedad source:


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.load();
myUILoader.move(10, 10);
addChild(myUILoader);

En el ejemplo siguiente, se crea una nueva instancia de UILoader y se carga una imagen con el método load() con una instancia de URLRequest:


import fl.containers.UILoader;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";
var req:URLRequest = new URLRequest(url);

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.move(10, 10);
myUILoader.load(req);
addChild(myUILoader);

loadBytes

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

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

Parámetros

	`bytes:ByteArray` — Objeto ByteArray que contiene un archivo en uno de los formatos admitidos por la clase Loader: SWF, GIF, JPEG o PNG.

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

Emite

	`ArgumentError` — La propiedad `length` del objeto ByteArray es 0.

	`IllegalOperationError` — Las propiedades `checkPolicyFile` o `securityDomain` del parámetro `context` no tiene el valor null.

	`SecurityError` — La propiedad `applicationDomain` de la propiedad `context` que se proporcionó procede de un dominio que no está permitido.

Véase también

source
Loader.loadBytes()
LoaderContext

Ejemplo

En el ejemplo siguiente, se cargan los bytes de un archivo GIF en un objeto UILoader:

import fl.containers.UILoader;

var imageBytes:Array = [ 71, 73, 70, 56, 57, 97, 50, 0, 30, 0, 230, 0, 0, 0, 0, 0, 173, 169, 206, 82, 73, 153, 74, 74, 74, 115, 109, 155, 248, 247, 251, 102, 102, 102, 26, 24, 35, 181, 181, 181, 70, 61, 145, 222, 222, 222, 153, 153, 153, 204, 204, 204, 58, 58, 58, 132, 132, 132, 231, 231, 231, 8, 7, 14, 90, 90, 90, 89, 81, 163, 153, 153, 153, 191, 188, 217, 165, 165, 165, 190, 190, 190, 237, 237, 233, 51, 51, 51, 214, 214, 214, 90, 82, 156, 156, 152, 190, 123, 123, 123, 140, 140, 140, 140, 135, 187, 103, 96, 165, 78, 70, 150, 173, 173, 173, 127, 121, 179, 82, 82, 82, 206, 204, 226, 195, 195, 193, 102, 102, 102, 247, 247, 247, 41, 41, 41, 66, 66, 66, 183, 179, 212, 146, 141, 190, 21, 21, 20, 227, 226, 238, 119, 111, 181, 198, 195, 221, 99, 91, 162, 255, 255, 255, 218, 216, 233, 114, 114, 114, 16, 15, 27, 114, 107, 171, 210, 208, 228, 8, 8, 8, 179, 175, 209, 240, 239, 246, 153, 153, 153, 234, 233, 243, 95, 88, 160, 90, 74, 156, 33, 33, 33, 16, 16, 16, 163, 159, 200, 142, 137, 188, 197, 189, 222, 134, 129, 183, 151, 147, 193, 202, 199, 223, 222, 221, 235, 122, 115, 176, 215, 213, 231, 74, 66, 147, 82, 75, 146, 197, 197, 197, 106, 99, 166, 231, 230, 240, 175, 171, 207, 239, 239, 239, 209, 207, 227, 25, 25, 22, 119, 112, 182, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 33, 249, 4, 0, 7, 0, 255, 0, 44, 0, 0, 0, 0, 50, 0, 30, 0, 0, 7, 255, 128, 49, 130, 131, 132, 132, 8, 24, 0, 16, 6, 15, 133, 141, 5, 54, 69, 77, 141, 147, 148, 147, 51, 63, 0, 153, 0, 40, 8, 148, 5, 1, 53, 48, 48, 31, 30, 50, 149, 167, 133, 5, 41, 154, 172, 0, 33, 141, 59, 76, 9, 2, 26, 181, 32, 32, 42, 168, 168, 170, 173, 172, 63, 23, 132, 59, 31, 32, 181, 197, 181, 73, 185, 186, 147, 5, 3, 189, 173, 29, 131, 194, 196, 198, 198, 184, 202, 141, 205, 206, 172, 35, 130, 77, 195, 212, 224, 73, 56, 215, 131, 217, 218, 154, 41, 49, 222, 211, 224, 212, 226, 228, 230, 231, 153, 6, 5, 223, 237, 237, 239, 186, 241, 242, 0, 11, 46, 236, 247, 194, 5, 64, 181, 79, 222, 129, 15, 180, 2, 6, 76, 226, 164, 82, 193, 115, 52, 148, 72, 80, 72, 145, 225, 164, 135, 218, 34, 242, 160, 200, 145, 225, 133, 12, 229, 248, 177, 210, 200, 177, 36, 136, 13, 140, 98, 112, 16, 169, 9, 130, 146, 141, 37, 75, 38, 121, 17, 195, 2, 38, 150, 81, 8, 76, 228, 40, 160, 39, 79, 38, 77, 26, 176, 4, 192, 130, 129, 148, 132, 10, 147, 0, 65, 162, 1, 169, 194, 32, 67, 127, 100, 40, 224, 244, 94, 18, 34, 130, 108, 248, 228, 200, 242, 7, 131, 24, 70, 170, 134, 91, 65, 8, 202, 86, 133, 17, 248, 121, 21, 148, 131, 135, 216, 98, 73, 255, 130, 52, 42, 114, 182, 157, 8, 5, 62, 206, 173, 29, 228, 33, 137, 85, 15, 148, 232, 190, 213, 0, 195, 84, 5, 109, 123, 7, 181, 104, 26, 110, 200, 169, 23, 32, 196, 38, 24, 40, 168, 195, 141, 86, 40, 190, 54, 34, 161, 33, 73, 207, 158, 73, 0, 163, 122, 33, 192, 115, 79, 16, 87, 11, 101, 152, 209, 0, 195, 128, 5, 39, 42, 237, 32, 194, 132, 7, 143, 35, 20, 174, 181, 88, 241, 193, 182, 8, 154, 228, 42, 229, 200, 17, 188, 184, 241, 224, 29, 150, 148, 0, 25, 35, 67, 133, 24, 39, 20, 44, 89, 18, 3, 1, 243, 37, 8, 136, 215, 68, 112, 34, 250, 146, 39, 5, 16, 88, 16, 36, 125, 73, 120, 230, 25, 16, 164, 44, 81, 194, 0, 2, 235, 5, 44, 116, 232, 244, 0, 67, 135, 8, 41, 58, 52, 200, 80, 194, 129, 131, 1, 49, 204, 48, 195, 2, 6, 224, 197, 65, 6, 35, 44, 192, 193, 12, 57, 160, 112, 95, 126, 13, 40, 16, 130, 1, 21, 140, 144, 129, 3, 51, 84, 128, 194, 18, 28, 148, 32, 31, 7, 6, 196, 160, 64, 4, 49, 44, 65, 162, 3, 11, 88, 128, 98, 10, 10, 164, 35, 72, 6, 0, 46, 48, 131, 32, 3, 88, 64, 98, 123, 42, 85, 136, 226, 12, 29, 112, 163, 146, 5, 28, 88, 16, 66, 7, 11, 0, 56, 98, 77, 33, 162, 56, 194, 88, 18, 10, 52, 240, 64, 4, 22, 40, 208, 1, 3, 36, 50, 48, 130, 116, 17, 28, 9, 100, 12, 14, 132, 224, 64, 7, 82, 142, 168, 94, 10, 37, 112, 16, 66, 10, 25, 48, 144, 194, 5, 90, 38, 89, 193, 2, 40, 140, 128, 65, 5, 12, 248, 224, 3, 7, 79, 10, 226, 128, 157, 37, 156, 192, 141, 5, 51, 114, 80, 193, 19, 24, 196, 121, 66, 157, 173, 49, 208, 161, 3, 40, 68, 208, 0, 7, 129, 0, 0, 59 ];

var totalBytes:uint = imageBytes.length;
var newBytes:ByteArray = new ByteArray()
var i:uint;
for(i=0; i<totalBytes; i++) {
    newBytes.writeByte(imageBytes[i]);
}

var loader:UILoader = new UILoader();
loader.loadBytes(newBytes);
addChild(loader);

setSize

()

método

public override function setSize(w:Number, h:Number):void

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Cambia el tamaño del componente al indicado. Si la propiedad scaleContent se define como true, no se cambia el tamaño de UILoader.

Parámetros

	`w:Number` — Anchura del componente, en píxeles.

	`h:Number` — Altura del componente, en píxeles.

Véase también

scaleContent

Ejemplo

En el ejemplo siguiente, se crea una instancia de componente UILoader y se cambia su tamaño en el escenario con el método setSize():


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
addChild(myUILoader);

function completeHandler(event:Event):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var image:DisplayObject = uiLdr.content as DisplayObject;
    trace("UILoader:", uiLdr.width, uiLdr.height); // 100 100
    trace("UILoader.content:", image.width, image.height); // 400 267
    uiLdr.setSize(image.width, image.height);
    uiLdr.move((stage.stageWidth - image.width) / 2, (stage.stageHeight - image.height) / 2);
}

unload

()

método

public function unload():void

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Quita un elemento secundario del objeto UILoader que se cargó utilizando el método load() o la propiedad source.

Véase también

load()
source

Ejemplo

En el ejemplo siguiente, se carga una imagen en un componente UILoader y se descarga la imagen cargada cuando se distribuye el evento click del componente de UILoader:


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myUILoader.move(10, 10);
myUILoader.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myUILoader);

function clickHandler(event:MouseEvent):void {
    var uil:UILoader = event.currentTarget as UILoader;
    uil.unload();
    removeChild(uil);
}

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.0.28.0

Se distribuye cuando se ha completado la carga del contenido. Este evento se distribuye independientemente de si la carga se activó mediante el parámetro autoload o una llamada explícita al método load().

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	El objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Objeto de red que ha terminado de cargarse.

Ejemplo

En el ejemplo siguiente, se crea una instancia UILoader y, una vez que se haya terminado de cargar la imagen especificada, se centra la imagen en el escenario:


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
addChild(myUILoader);

function completeHandler(event:Event):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var newX:uint = (stage.stageWidth - uiLdr.content.width) / 2;
    var newY:uint = (stage.stageHeight - uiLdr.content.height) / 2;
    uiLdr.move(newX, newY);
}

Véase también

progress

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.0.28.0

Se distribuye cuando las propiedades y métodos de un archivo SWF cargado están accesibles. Se deben cumplir las condiciones siguientes para que se distribuya este evento:

Todos los métodos y propiedades que se asocian al objeto cargado, así como los que están asociados al componente, deben estar accesibles.
Los constructores de todos los objetos secundarios deben haber finalizado.

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	El objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Objeto LoaderInfo asociado al archivo SWF que se está cargando.

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.0.28.0

Se distribuye después de que se produzca un error de entrada/salida.

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	El objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	El objeto de red en el que se produce el error de entrada/salida.
`text`	Texto que se mostrará como mensaje de error.

Ejemplo

En el ejemplo siguiente, se crea una instancia de componente UILoader y se intenta cargar un archivo no existente que hace que se distribuya el evento ioError:


import fl.containers.UILoader;

var url:String = "http://www.helpexamples.com/flash/images/image404.jpg"

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.move(10, 10);
myUILoader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
addChild(myUILoader);

function ioErrorHandler(event:IOErrorEvent):void {
    trace("<<", event.text, ">>");
    myUILoader.removeEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
    removeChild(myUILoader);
}

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.0.28.0

Se distribuye cuando se inicia una operación de red.

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	El objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Objeto de red que ha abierto una conexió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.0.28.0

Se distribuye cuando se está cargando el contenido. Este evento se distribuye independientemente de si la carga se activó mediante el parámetro autoload o una llamada explícita al método load().

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`bytesLoaded`	Número de elementos o bytes cargados en el momento en que el detector procesa el evento.
`bytesTotal`	Número total de elementos o bytes que se cargarán en última instancia si el proceso de carga se realiza correctamente.
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	El objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	El objeto de red que informa sobre el progreso.

Ejemplo


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

Véase también

complete

resize

Evento

Tipo de objeto de evento: fl.events.ComponentEvent
ComponentEvent.type property = fl.events.ComponentEvent.RESIZE

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Se distribuye cuando se cambia el tamaño del componente.

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Error que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad `currentTarget` para acceder al objeto que detecta el evento.

Ejemplo

En el ejemplo siguiente, se crea una instancia de componente UILoader, se detecta el evento resize y se centra la imagen en el escenario una vez que se haya terminado de cargar:


import fl.containers.UILoader;
import fl.events.ComponentEvent;

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.addEventListener(ComponentEvent.RESIZE, resizeHandler);
addChild(myUILoader);

function resizeHandler(event:ComponentEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    trace(uiLdr.width, uiLdr.height); // 400 267
    uiLdr.move((stage.stageWidth - uiLdr.width) / 2, (stage.stageHeight - uiLdr.height) / 2);
}

securityError

Evento

Tipo de objeto de evento: flash.events.SecurityErrorEvent
SecurityErrorEvent.type property = flash.events.SecurityErrorEvent.SECURITY_ERROR

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Se distribuye cuando se produce un error de seguridad mientras se está cargando el contenido.

La constante SecurityErrorEvent.SECURITY_ERROR define el valor de la propiedad type de un objeto de evento securityError.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	El objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	El objeto de red que informa sobre le error de seguridad.
`text`	Texto que se mostrará como mensaje de error.

Ejemplos Cómo utilizar los ejemplos

UILoaderExample.as

En este ejemplo se muestra una simple interacción con la clase UILoader.

Para realizar el ejemplo, siga estos pasos:

Coloque una instancia del componente UILoader en el escenario y asígnele un nombre de instancia de uiLoader.
Coloque una instancia del componente Label sobre la instancia UILoader y asígnele un nombre de instancia de uiLoaderLabel.
Guarde este código como UILoaderExample.as en el mismo directorio que el archivo FLA.
Defina la clase Document en el archivo FLA como UILoaderExample.

package
{
    import flash.display.Sprite;
    import flash.events.Event;
    import flash.events.ProgressEvent;
    import flash.net.URLRequest;

    public class UILoaderExample extends Sprite
    {
        private var sampleImagePath:String = "test.jpg";

        public function UILoaderExample() {
            var request:URLRequest = new URLRequest(sampleImagePath);
            uiLoader.scaleContent = false;
            uiLoader.addEventListener(Event.COMPLETE,loadComplete);
            uiLoader.addEventListener(ProgressEvent.PROGRESS,loadProgress);
            uiLoader.load(request);
        }
        private function loadProgress(e:ProgressEvent):void {
            uiLoaderLabel.text = String(e.target.percentLoaded);
        }
        private function loadComplete(e:Event):void {
            uiLoaderLabel.text = "Load Complete";
        }
    }
}

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/fl/containers/UILoader.html

Referencia del lenguaje y componentes ActionScript 3.0		Todos los paquetes \| Todas las clases \| Elementos del lenguaje \| Índice \| Apéndices \| Convenciones \| Marcos Quitar marcos
UILoader	Propiedades \| Métodos \| Eventos \| Estilos \| Ejemplos

Paquete	fl.containers
Clase	public class UILoader
Herencia	UILoader UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object