fl.controls.ProgressBar (ActionScript 3.0)

Propiedades públicas

	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
		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
		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
		contextMenu : ContextMenu Especifica el menú contextual asociado a este objeto.	InteractiveObject
		direction : String Indica la dirección de relleno de la barra de progreso.	ProgressBar
		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
		indeterminate : Boolean Obtiene o define un valor que indica el tipo de relleno que utiliza la barra de progreso y si el origen de carga es conocido o desconocido.	ProgressBar
		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
		mask : DisplayObject El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado.	DisplayObject
		maximum : Number Obtiene o establece el valor máximo de la barra de progreso cuando la propiedad ProgressBar.mode se define como ProgressBarMode.MANUAL.	ProgressBar
		minimum : Number Obtiene o establece el valor mínimo de la barra de progreso cuando la propiedad ProgressBar.mode se define como ProgressBarMode.MANUAL.	ProgressBar
		mode : String Obtiene o define el método que se va a emplear para actualizar la barra de progreso.	ProgressBar
		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
		percentComplete : Number [read-only] Obtiene un número entre 0 y 100 que indica el porcentaje de contenido que ya se ha cargado.	ProgressBar
		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
		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 referencia al contenido que se está cargando y para el que ProgressBar mide el progreso de la operación de carga.	ProgressBar
		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
		value : Number Obtiene o define un valor que indica la cantidad de progreso de la operación de carga.	ProgressBar
		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étodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		ProgressBar() Crea una instancia de componente ProgressBar nueva.	ProgressBar
		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
		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.	ProgressBar
		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
		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
		reset():void Restablece la barra de progreso para una nueva operación de carga.	ProgressBar
		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
		setProgress(value:Number, maximum:Number):void Establece el estado de la barra para reflejar la cantidad de progreso realizado cuando se utiliza el modo manual.	ProgressBar
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		setSize(width:Number, height:Number):void Define el componente en la anchura y altura especificadas.	UIComponent
		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
		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 finaliza la operación de carga.	ProgressBar
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
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
progress	Se distribuye a medida que se carga el contenido en modo event o polled.	ProgressBar
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.	UIComponent
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
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
barPadding	Tipo: Number Formato: Length El relleno que separa el indicador de la barra de progreso de la pista, expresado en píxeles. El valor predeterminado es `0`.	ProgressBar
barSkin	Tipo: Class Nombre de la clase que se utiliza como la barra de progreso determinada. El valor predeterminado es `ProgressBar_barSkin`.	ProgressBar
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
icon	Tipo: Class Nombre de la clase que se utiliza como icono predeterminado La configuración de otro estilo de icono sobrescribe esta configuración. El valor predeterminado es `null`.	ProgressBar
indeterminateBar	Tipo: Class La clase que se utilizará como procesador para la animación de la barra indeterminada. Se trata de un estilo avanzado. El valor predeterminado es `fl.controls.progressBarClasses.IndeterminateBar`.	ProgressBar
indeterminateSkin	Tipo: Class Nombre de la clase que se utiliza como barra de progreso indeterminada. Éste se transfiere al procesador de barras indeterminadas, que está especificado por el estilo `indeterminateBar`. El valor predeterminado es `ProgressBar_indeterminateSkin`.	ProgressBar
textFormat	Tipo: flash.text.TextFormat El objeto TextFormat que se utilizará para representar la etiqueta del componente.	UIComponent
trackSkin	Tipo: Class Nombre de la clase que se utiliza como la pista del indicador de progreso. El valor predeterminado es `ProgressBar_trackSkin`.	ProgressBar

Información sobre propiedades

direction

propiedad

direction:String [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Indica la dirección de relleno de la barra de progreso. ProgressBarDirection.RIGHT especifica que la barra de progreso se rellena de izquierda a derecha. ProgressBarDirection.LEFT especifica que la barra de progreso se rellena de derecha a izquierda.

El valor predeterminado es ProgressBarDirection.RIGHT.

Implementación
public function get direction():String
public function set direction(value:String):void

Véase también

ProgressBarDirection

Ejemplo

En el ejemplo siguiente, se muestra la diferencia entre una barra de progreso que carga desde la izquierda y otra que lo hace desde la derecha. Reemplace testPath por un archivo de gran tamaño para realizar una prueba local:


import fl.controls.ProgressBar;
import fl.controls.ProgressBarDirection;

var testPath:String = "largeVideo.flv";
var loader:URLLoader = new URLLoader();
loader.load(new URLRequest(testPath));

var leftProgressBar:ProgressBar = new ProgressBar();
leftProgressBar.move(10,10);
leftProgressBar.direction = ProgressBarDirection.LEFT;
leftProgressBar.source = loader;
addChild(leftProgressBar);

var rightProgressBar:ProgressBar = new ProgressBar();
rightProgressBar.move(10,40);
rightProgressBar.source = loader;
rightProgressBar.direction = ProgressBarDirection.RIGHT;
addChild(rightProgressBar);

indeterminate

propiedad

indeterminate: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 el tipo de relleno que utiliza la barra de progreso y si el origen de carga es conocido o desconocido. true determina que la barra tiene un relleno discontinuo y un origen de carga de tamaño desconocido. false indica que la barra tiene un relleno continuo y un origen de carga con un tamaño conocido.

Esta propiedad sólo se puede definir si el modo de la barra de progreso se establece en ProgressBarMode.MANUAL.

El valor predeterminado es true.

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

Véase también

mode
ProgressBarMode
IndeterminateBar

maximum

propiedad

maximum:Number [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Obtiene o establece el valor máximo de la barra de progreso cuando la propiedad ProgressBar.mode se define como ProgressBarMode.MANUAL.

El valor predeterminado es 0.

Implementación
public function get maximum():Number
public function set maximum(value:Number):void

Véase también

minimum
percentComplete
value
ProgressBarMode.MANUAL

minimum

propiedad

minimum:Number [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Obtiene o establece el valor mínimo de la barra de progreso cuando la propiedad ProgressBar.mode se define como ProgressBarMode.MANUAL.

El valor predeterminado es 0.

Implementación
public function get minimum():Number
public function set minimum(value:Number):void

Véase también

maximum
percentComplete
value
ProgressBarMode.MANUAL

mode

propiedad

mode:String [read-write]

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Obtiene o define el método que se va a emplear para actualizar la barra de progreso.

Los valores siguientes son válidos para esta propiedad:

ProgressBarMode.EVENT
ProgressBarMode.POLLED
ProgressBarMode.MANUAL

Los modos más frecuentes son event y polled. En el modo event, la propiedad source especifica el contenido de carga que genera eventos progress y complete; en este modo debe utilizar un objeto UILoader. En el modo polled, la propiedad source especifica el contenido de carga (por ejemplo, una clase personalizada) que muestra propiedades bytesLoaded y bytesTotal. Cualquier objeto que exponga estas propiedades, se puede utilizar como origen en modo polled.

También puede utilizar el componente ProgressBar en modo manual si define manualmente las propiedades maximum y minimum y llama al método ProgressBar.setProgress().

El valor predeterminado es ProgressBarMode.EVENT.

Implementación
public function get mode():String
public function set mode(value:String):void

Véase también

ProgressBarMode

percentComplete

propiedad

percentComplete: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 de contenido que ya se ha cargado.

Para modificar el valor del porcentaje, utilice el método setProgress().

El valor predeterminado es 0.

Implementación
public function get percentComplete():Number

Véase también

maximum
minimum
setProgress()
value

Ejemplo

En el ejemplo siguiente, se crean instancias de los componentes ProgressBar y Label para mostrar el estado de la barra de progreso:


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

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.indeterminate = false;
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.maximum = 256;
myProgressBar.setSize(320, 16);
myProgressBar.move(10, 10)
addChild(myProgressBar);

var myLabel:Label = new Label();
myLabel.text = "";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myProgressBar.x, myProgressBar.y + myProgressBar.height);
addChild(myLabel);

var t:Timer = new Timer(150);
t.addEventListener(TimerEvent.TIMER, timerHandler);
t.start();

function timerHandler(event:TimerEvent):void {
    myProgressBar.setProgress(myProgressBar.value + 1, myProgressBar.maximum);
    if (myProgressBar.percentComplete == 100) {
        myProgressBar.setProgress(0, myProgressBar.maximum);
    }
    myLabel.text = int(myProgressBar.value) + " of " + int(myProgressBar.maximum) + " (" + int(myProgressBar.percentComplete) + "%)";
}

En el ejemplo siguiente, se muestra cómo controlar el progreso de la carga a través del acceso a la propiedad percentLoaded. En primer lugar, es necesario definir la variable dataPath en un archivo remoto:

import fl.controls.ProgressBar;
import fl.controls.Label

var dataPath:String = "test.txt";
var loader:URLLoader = new URLLoader();
loader.load(new URLRequest(dataPath));

var progressReport:Label = new Label();
progressReport.move(10,30);
progressReport.autoSize = TextFieldAutoSize.LEFT;
addChild(progressReport);

var pb:ProgressBar = new ProgressBar();
pb.move(10,10);
pb.source = loader;
pb.addEventListener(ProgressEvent.PROGRESS,updateProgressReport);
addChild(pb);

function updateProgressReport(e:ProgressEvent):void {
    progressReport.text = Math.round(pb.percentComplete) + "% Loaded";
}

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 referencia al contenido que se está cargando y para el que ProgressBar mide el progreso de la operación de carga. Lo habitual es definir esta propiedad en un componente UILoader.

Utilice esta propiedad sólo en los modos event y polled.

El valor predeterminado es null.

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

Ejemplo

En el ejemplo siguiente, se muestra cómo establecer un vínculo entre una barra de progreso y un cargador mediante la propiedad source. Para que la barra de progreso muestre el proceso de carga, en primer lugar es necesario definir la variable dataPath en un archivo remoto:

import fl.controls.ProgressBar;

var dataPath:String = "test.txt";
var loader:URLLoader = new URLLoader();
loader.load(new URLRequest(dataPath));

var pb:ProgressBar = new ProgressBar();
pb.source = loader;
addChild(pb);

En el ejemplo siguiente, se define la propiedad source para que una barra de progreso se desplace por un panel:


import fl.containers.ScrollPane;
import fl.controls.ProgressBar;

var myScrollPane:ScrollPane = new ScrollPane();
myScrollPane.setSize(320, 240);
myScrollPane.move(10, 10);
myScrollPane.source = "http://www.helpexamples.com/flash/images/image3.jpg";
addChild(myScrollPane);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.width = myScrollPane.width;
myProgressBar.move(myScrollPane.x, myScrollPane.y - myProgressBar.height);
myProgressBar.source = myScrollPane;
addChild(myProgressBar);

value

propiedad

value:Number [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 la cantidad de progreso de la operación de carga. El valor es un número entre los valores minimum y maximum.

El valor predeterminado es 0.

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

Véase también

maximum
minimum
percentComplete

Información sobre constructores

ProgressBar

()

constructor

public function ProgressBar()

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Crea una instancia de componente ProgressBar nueva.

Información sobre métodos

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

fl.core.UIComponent.getStyle()
fl.core.UIComponent.setStyle()
fl.managers.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;
}

reset

()

método

public function reset():void

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Restablece la barra de progreso para una nueva operación de carga.

setProgress

()

método

public function setProgress(value:Number, maximum:Number):void

Versión del lenguaje:

ActionScript 3.0

Versión del reproductor:

Flash Player 9.0.28.0

Establece el estado de la barra para reflejar la cantidad de progreso realizado cuando se utiliza el modo manual. El argumento value se asigna a la propiedadvalue y maximum se asigna a la propiedad maximum. La propiedad minimum no cambia.

Parámetros

	`value:Number` — Valor que describe el progreso que se ha realizado.

	`maximum:Number` — Valor máximo de la barra de progreso.

Véase también

maximum
value
ProgressBarMode.manual

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 finaliza la operación de carga.

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 carga una imagen externa mediante un componente UILoader y, cuando se termina la carga de la imagen, se oculta un componente ProgressBar y Label:


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

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

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.source = url;
myUILoader.move(10, 10);
myUILoader.scaleContent = false;
myUILoader.load();

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.source = myUILoader;
myProgressBar.move(myUILoader.x, myUILoader.y);
myProgressBar.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myProgressBar.addEventListener(Event.COMPLETE, completeHandler);
addChild(myProgressBar)

var myLabel:Label = new Label();
myLabel.text = "xx";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myProgressBar.x, myProgressBar.y + myProgressBar.height);
addChild(myLabel);

function progressHandler(event:ProgressEvent):void {
    trace("progress:", event.bytesLoaded, event.bytesTotal, int(event.currentTarget.percentComplete) + "%");
    myLabel.text = event.bytesLoaded + " of " + event.bytesTotal + " bytes loaded.";
}

function completeHandler(event:Event):void {
    trace("complete:");
    myProgressBar.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myProgressBar.removeEventListener(Event.COMPLETE, completeHandler);
    removeChild(myProgressBar);
    removeChild(myLabel);

    addChild(myUILoader);
}

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 a medida que se carga el contenido en modo event o polled.

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

En el ejemplo siguiente, se carga una imagen externa mediante un componente UILoader y, cuando se termina la carga de la imagen, se oculta un componente ProgressBar y Label:


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

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

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.source = url;
myUILoader.move(10, 10);
myUILoader.scaleContent = false;
myUILoader.load();

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.source = myUILoader;
myProgressBar.move(myUILoader.x, myUILoader.y);
myProgressBar.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myProgressBar.addEventListener(Event.COMPLETE, completeHandler);
addChild(myProgressBar)

var myLabel:Label = new Label();
myLabel.text = "xx";
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.move(myProgressBar.x, myProgressBar.y + myProgressBar.height);
addChild(myLabel);

function progressHandler(event:ProgressEvent):void {
    trace("progress:", event.bytesLoaded, event.bytesTotal, int(event.currentTarget.percentComplete) + "%");
    myLabel.text = event.bytesLoaded + " of " + event.bytesTotal + " bytes loaded.";
}

function completeHandler(event:Event):void {
    trace("complete:");
    myProgressBar.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myProgressBar.removeEventListener(Event.COMPLETE, completeHandler);
    removeChild(myProgressBar);
    removeChild(myLabel);

    addChild(myUILoader);
}

Véase también

ProgressBarMode.EVENT
ProgressBarMode.POLLED

Ejemplos Cómo utilizar los ejemplos

ProgressBarExample.as

Este ejemplo muestra cómo definir manualmente el progreso de una instancia de componente ProgressBar.

Para realizar el ejemplo, siga estos pasos:

Añada los componentes ProgressBar, Label y Button a la biblioteca.
Guarde este código como ProgressBarExample.as en el mismo directorio que el archivo FLA.
Defina la clase Document como ProgressBarExample en el archivo FLA.

package
{
    import fl.controls.Button;
    import fl.controls.ProgressBar;
    import fl.controls.ProgressBarMode;
    import flash.display.Sprite;
    import flash.events.MouseEvent;

    public class ProgressBarExample extends Sprite
    {
        private var j:uint;
        private var pb:ProgressBar;
        private var fakeProgressCount:uint;

        public function ProgressBarExample() {
            setupProgressBar();
            setupButton();
        }

        private function advancePreloader(e:MouseEvent):void {
            fakeProgressCount = (fakeProgressCount == 100) ? 0 : fakeProgressCount + 10;
            pb.setProgress(fakeProgressCount, 100);
        }

        private function setupButton():void {
            var b:Button = new Button();
            b.move(10, 30);
            b.setSize(120, 20);
            b.label = "Increment Progress";
            b.addEventListener(MouseEvent.CLICK, advancePreloader);
            addChild(b);
        }

        private function setupProgressBar():void {
            fakeProgressCount = 0;
            pb = new ProgressBar();
            pb.move(10, 10);
            pb.mode = ProgressBarMode.MANUAL;
            addChild(pb);
        }
    }
}

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/fl/controls/ProgressBar.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
ProgressBar	Propiedades \| Métodos \| Eventos \| Estilos \| Ejemplos

Paquete	fl.controls
Clase	public class ProgressBar
Herencia	ProgressBar UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object