UILoader

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

La clase UILoader hace posible definir contenido para cargar y, a continuación, controlar la operación de carga en tiempo de ejecución. Esta clase también gestiona el cambio de tamaño del contenido cargado. Si se carga contenido desde un dominio diferente (entorno limitado de seguridad), las medidas de seguridad pueden implicar que no se pueda acceder a las propiedades del contenido. Para más información, consulte la clase ProLoader.

El uso de ActionScript para definir una propiedad de la clase UILoader reemplaza el parámetro del mismo nombre que se define en el inspector de propiedades o el inspector de componentes.

Este componente ajusta flash.display.ProLoader. La clase ProLoader gestiona toda la carga actual; UILoader sólo proporciona una presentación visual para el objeto ProLoader.

Nota: cuando el contenido se carga desde otro dominio o entorno limitado, puede que las propiedades del contenido no estén accesibles por motivos de seguridad. Para más información sobre cómo la seguridad del dominio afecta al proceso de carga, consulte la clase ProLoader.

Ver los ejemplos

Elementos de API relacionados

ProLoader

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
		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
		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
		bytesLoaded : uint [solo lectura] Obtiene el recuento de bytes de contenido que se han cargado.	UILoader
		bytesTotal : uint [solo lectura] Obtiene el recuento de bytes del contenido que se va a cargar.	UILoader
		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 de imagen (archivo de formato JPG, PNG o GIF) que se cargó mediante el método load() o definiendo la propiedad source.	UILoader
		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
		enabled : Boolean Obtiene o define un valor que indica si el componente puede aceptar la interacción del usuario.	UIComponent
		filters : Array Conjunto indexado 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 [solo lectura] Especifica el objeto Graphics que pertenece a este elemento sprite, donde pueden ejecutarse comandos de dibujo vectorial.	Sprite
		height : Number [override] 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 [solo lectura] 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
		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
		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 [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
		percentLoaded : Number [solo lectura] Obtiene un número entre 0 y 100 que indica el porcentaje del contenido cargado.	UILoader
		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
		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 [override] Multiplica la anchura actual del componente por un factor de escala.	UIComponent
		scaleY : Number [override] Multiplica la altura actual del componente por un factor de escala.	UIComponent
		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
		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 [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
		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 [override] Obtiene o define un valor que indica si la instancia del componente actual es visible.	UIComponent
		width : Number [override] Obtiene o define la anchura del componente, expresada en píxeles.	UIComponent
		x : Number [override] 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 [override] Obtiene o define la coordenada y que representa la posición del componente a lo largo del eje y en su contenedor principal.	UIComponent
		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
		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 ProLoader.	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 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
		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 [estática] 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
		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
		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
		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
		mergeStyles(... list):Object [estática] 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
		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
		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 [override] 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
		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 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

Métodos protegidos

Ocultar métodos protegidos heredados

Mostrar métodos protegidos heredados

	Método		Definido por
		getStyleValue(name:String):Object Devuelve el estilo especificado para un componente; tiene en cuenta todos los estilos definidos en el nivel global, en el nivel de componentes y en el nivel de instancias.	UIComponent

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
complete	Se distribuye cuando se ha completado la carga del contenido.	UILoader
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
hide	Se distribuye cuando la visibilidad del componente cambia de visible a invisible.	UIComponent
imeStartComposition	Este evento se distribuye a cualquier cliente app que admite entrada en línea con un IME	InteractiveObject
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
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
move	Se distribuye cuando se mueve el componente.	UIComponent
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
open	Se distribuye cuando se inicia una operación de red.	UILoader
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
progress	Se distribuye cuando se está cargando el contenido.	UILoader
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
resize	Se distribuye cuando se cambia el tamaño del componente.	UILoader
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
securityError	Se distribuye cuando se produce un error de seguridad mientras se está cargando el contenido.	UILoader
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
show	Se distribuye cuando la visibilidad del componente cambia de invisible a visible.	UIComponent
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

Estilos

Los estilos son comunes o están asociados a un tema específico. Si el estilo es común, se puede utilizar con cualquier tema. Si un estilo está asociado a un tema específico, solo se puede utilizar si la aplicación usa dicho tema.

Estilos comunes

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

Ocultar estilos heredados

Mostrar estilos heredados

	Descripción	Definido por
disabledTextFormat	Tipo: flash.text.TextFormat Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El objeto TextFormat que se utilizará para representar la etiqueta del componente cuando el botón esté desactivado.	UIComponent
focusRectPadding	Tipo: Number Formato: Length Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 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 Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El aspecto que se utilizará para mostrar los indicadores de selección.	UIComponent
textFormat	Tipo: flash.text.TextFormat Versión del lenguaje: ActionScript 3.0 Versión de producto: Flash CS3 Versiones de motor de ejecución: Flash9.0.28.0, AIR 1.0 El objeto TextFormat que se utilizará para representar la etiqueta del componente.	UIComponent

Constantes públicas

Ocultar constantes públicas heredadas

Mostrar constantes públicas heredadas

	Constante		Definido por
		version : String = "3.0.3.1" Número de versión de los componentes.	UIComponent

Información sobre propiedades

autoLoad

propiedad

autoLoad:Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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

Elementos de API relacionados

load()
source

Ejemplo ( Cómo utilizar este 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 [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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

Elementos de API relacionados

bytesTotal
percentLoaded

Ejemplo ( Cómo utilizar este 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 [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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

Elementos de API relacionados

bytesLoaded
percentLoaded

Ejemplo ( Cómo utilizar este 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 [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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

Elementos de API relacionados

complete
load()
source

Ejemplo ( Cómo utilizar este 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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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

Elementos de API relacionados

scaleContent

Ejemplo ( Cómo utilizar este 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 [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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

Elementos de API relacionados

bytesLoaded
bytesTotal

Ejemplo ( Cómo utilizar este 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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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

Elementos de API relacionados

maintainAspectRatio

Ejemplo ( Cómo utilizar este 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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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

Elementos de API relacionados

autoLoad
load()

Ejemplo ( Cómo utilizar este 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

()

Información sobre

public function UILoader()

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Crea una nueva instancia del componente UILoader.

Información sobre métodos

close

()

método

public function close():void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

Cancela una operación de método load() que está actualmente en curso para la instancia de ProLoader. 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.

Elementos de API relacionados

load()
source

Ejemplo ( Cómo utilizar este 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 de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

Elementos de API relacionados

UIComponent.getStyle()
UIComponent.setStyle()
StyleManager

Ejemplo ( Cómo utilizar este 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 de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

Elementos de API relacionados

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

Ejemplo ( Cómo utilizar este 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 de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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 ProLoader: 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.

Elementos de API relacionados

source
ProLoader.loadBytes()
LoaderContext

Ejemplo ( Cómo utilizar este 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

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

Elementos de API relacionados

scaleContent

Ejemplo ( Cómo utilizar este 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 de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

Elementos de API relacionados

load()
source

Ejemplo ( Cómo utilizar este 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
propiedad Event.type = flash.events.Event.COMPLETE

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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().

La constante Event.COMPLETE 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`	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 ( Cómo utilizar este 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);
}

Elementos de API relacionados

progress

init

Evento

Tipo de objeto de evento: flash.events.Event
propiedad Event.type = flash.events.Event.INIT

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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.

La constante Event.INIT 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`	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
propiedad IOErrorEvent.type = flash.events.IOErrorEvent.IO_ERROR

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`errorID`	Un número de referencia asociado al error concreto (sólo AIR).
`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 ( Cómo utilizar este 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
propiedad Event.type = flash.events.Event.OPEN

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

La constante Event.OPEN 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`	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
propiedad ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	El objeto que informa sobre el progreso.

Ejemplo ( Cómo utilizar este 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);
}

Elementos de API relacionados

complete

resize

Evento

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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 ( Cómo utilizar este 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
propiedad SecurityErrorEvent.type = flash.events.SecurityErrorEvent.SECURITY_ERROR

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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`	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 este ejemplo

UILoaderExample.as

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

Coloca una instancia de UILoader en el escenario y le asigna el nombre de "uiLoader".
Coloca una instancia de Label encima de la instancia de UILoader y le asigna el nombre de "uiLoaderLabel".
Guarde este código como UILoaderExample.as en el mismo directorio que el archivo FLA.
Establece la clase DocumentClass del archivo FLA como UILoaderExample.

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

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

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

UILoader - AS3 Flash

Paquetesx

Elementos del lenguaje

Apéndices

Paquete fl.containers

autoLoad

bytesLoaded

bytesTotal

content

maintainAspectRatio

percentLoaded

scaleContent

source

UILoader

close

getStyleDefinition

load

loadBytes

setSize

unload

complete

init

ioError

open

progress

resize

securityError