ProgressBar

Pacote	fl.controls
Classe	public class ProgressBar
Herança	ProgressBar UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

O componente ProgressBar exibe o progresso do conteúdo que está sendo carregado. ProgressBar é normalmente usado para exibir o status de imagens, bem como partes de aplicativos, enquanto estão sendo carregados. O processo de carregamento pode ser determinado ou indeterminado. Uma barra de progresso determinada é uma representação linear do progresso de uma tarefa ao longo do tempo, e é utilizada quando a quantidade de conteúdo a ser carregada é conhecida. Uma barra de progresso indeterminada tem um preenchimento listrado e uma fonte de carregamento de tamanho desconhecido.

Veja os exemplos

Elementos da API relacionados

ProgressBarDirection
ProgressBarMode

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		accessibilityImplementation : AccessibilityImplementation A implementação de acessibilidade atual (AccessibilityImplementation) para esta instância do InteractiveObject.	InteractiveObject
		accessibilityProperties : AccessibilityProperties As opções de acessibilidade atuais para este objeto de exibição.	DisplayObject
		alpha : Number Indica o valor de transparência alfa do objeto especificado.	DisplayObject
		blendMode : String Um valor a partir da classe BlendMode que especifica o modo de mesclagem a ser usado.	DisplayObject
		blendShader : Shader [somente gravação] Define um shader usado para mesclar o primeiro plano e o segundo plano.	DisplayObject
		buttonMode : Boolean Especifica o modo de botão desta entidade gráfica.	Sprite
		cacheAsBitmap : Boolean Se definido como true, tempo de execução do Flash armazenará em cachê uma representação interna em bitmap do objeto de exibição.	DisplayObject
		cacheAsBitmapMatrix : Matrix Se não nulo, este objeto Matrix definirá como um objeto exibição será renderizado quando cacheAsBitmap for definido como verdadeiro.	DisplayObject
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		contextMenu : NativeMenu Especifica o menu de contexto associado a este objeto.	InteractiveObject
		direction : String Indica a direção de preenchimento da barra de progresso.	ProgressBar
		doubleClickEnabled : Boolean Especifica se o objeto recebe eventos doubleClick.	InteractiveObject
		dropTarget : DisplayObject [somente leitura] Especifica o objeto de exibição sobre o qual a entidade gráfica está sendo arrastada ou no qual a entidade gráfica foi solta.	Sprite
		enabled : Boolean Obtém ou define um valor que indica se o componente pode aceitar a interação do usuário.	UIComponent
		filters : Array Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição.	DisplayObject
		focusEnabled : Boolean Obtém ou define um valor booliano que indica se o componente pode receber foco depois que o usuário clicar nele.	UIComponent
		focusManager : IFocusManager Obtém ou define o FocusManager que controla o foco para este componente e seus semelhantes.	UIComponent
		focusRect : Object Especifica se este objeto exibe um retângulo de foco.	InteractiveObject
		graphics : Graphics [somente leitura] Especifica o objeto Graphics pertencente a esta entidade gráfica em que comandos de desenho de vetor podem ocorrer.	Sprite
		height : Number [substituir] Obtém ou define a altura do componente, em pixels.	UIComponent
		hitArea : Sprite Designa outra entidade gráfica para atuar como área de ocorrência para uma entidade gráfica.	Sprite
		indeterminate : Boolean Obtém ou define um valor que indica o tipo de preenchimento que a barra de progresso utiliza e se a fonte de carregamento é conhecida ou desconhecida.	ProgressBar
		loaderInfo : LoaderInfo [somente leitura] Retorna um objeto LoaderInfo contendo informações sobre o carregamento do arquivo ao qual esse objeto de exibição pertence.	DisplayObject
		mask : DisplayObject O objeto de exibição de chamada é mascarado pelo objeto "mask" especificado.	DisplayObject
		maximum : Number Obtém ou define o valor máximo da barra de progresso quando a propriedade ProgressBar.mode é definida como ProgressBarMode.MANUAL.	ProgressBar
		metaData : Object Obtém o objeto de metadados da instância DisplayObject se os metadados forem armazenados juntamente com a instância desse DisplayObject no arquivo SWF por uma marca PlaceObject4.	DisplayObject
		minimum : Number Obtém ou define o valor mínimo da barra de progresso quando a propriedade ProgressBar.mode é definida como ProgressBarMode.MANUAL.	ProgressBar
		mode : String Obtém ou define o método a ser usado para atualizar a barra de progresso.	ProgressBar
		mouseChildren : Boolean Determina se os filhos do objeto são ou não ativados pelo mouse, ou dispositivo de entrada do usuário.	DisplayObjectContainer
		mouseEnabled : Boolean Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários.	InteractiveObject
		mouseFocusEnabled : Boolean Obtém ou define um valor que indica se o componente pode receber foco depois que o usuário clicar nele.	UIComponent
		mouseX : Number [somente leitura] Indica a coordenada x da posição do dispositivo do mouse ou de entrada do usuário, em pixels.	DisplayObject
		mouseY : Number [somente leitura] Indica a coordenada y da posição do dispositivo do mouse ou de entrada do usuário, em pixels.	DisplayObject
		name : String Indica o nome da ocorrência de DisplayObject.	DisplayObject
		needsSoftKeyboard : Boolean Especifica se um teclado virtual (teclado de software, na tela) deve ser exibido quando esta instância InteractiveObject recebe foco.	InteractiveObject
		numChildren : int [somente leitura] Retorna o número de filhos deste objeto.	DisplayObjectContainer
		opaqueBackground : Object Especifica se o objeto de exibição é opaco com uma certa cor de plano de fundo.	DisplayObject
		parent : DisplayObjectContainer [somente leitura] Indica o objeto DisplayObjectContainer que contém esse objeto de exibição.	DisplayObject
		percentComplete : Number [somente leitura] Obtém um número entre 0 e 100 que indica a porcentagem do conteúdo já carregada.	ProgressBar
		root : DisplayObject [somente leitura] Para um objeto de exibição em um arquivo SWF carregado, a propriedade "root" é o objeto de exibição na extremidade superior, na parte da estrutura em árvore da lista de exibição representada por esse arquivo SWF.	DisplayObject
		rotation : Number Indica o giro da ocorrência de DisplayObject, em graus, a partir da sua orientação original.	DisplayObject
		rotationX : Number Indica a rotação do eixo x da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent.	DisplayObject
		rotationY : Number Indica a rotação do eixo y da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent.	DisplayObject
		rotationZ : Number Indica a rotação do eixo z da ocorrência DisplayObject, em graus, a partir da sua orientação original referente ao contêiner 3D parent.	DisplayObject
		scale9Grid : Rectangle A grade de dimensionamento atual que está em vigor.	DisplayObject
		scaleX : Number [substituir] Multiplica a largura atual do componente por um fator escalar.	UIComponent
		scaleY : Number [substituir] Multiplica a altura atual do componente por um fator escalar.	UIComponent
		scaleZ : Number Indica a escala de profundidade (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto.	DisplayObject
		scrollRect : Rectangle Os limites do retângulo de rolagem do objeto de exibição.	DisplayObject
		softKeyboard : String Controla a aparência do teclado suave.	InteractiveObject
		softKeyboardInputAreaOfInterest : Rectangle Define a área que deve permanecer na tela quando um teclado virtual for exibido (não disponível no iOS)	InteractiveObject
		soundTransform : flash.media:SoundTransform Controla o som nesta entidade gráfica.	Sprite
		source : Object Obtém ou define uma referência ao conteúdo que está sendo carregado e para o qual ProgressBar está medindo o progresso da operação de carregamento.	ProgressBar
		stage : Stage [somente leitura] O Palco do objeto de exibição.	DisplayObject
		tabChildren : Boolean Determina se os filhos do objeto estão ativados para tabulação.	DisplayObjectContainer
		tabEnabled : Boolean Especifica se este objeto está na ordem de tabulação.	InteractiveObject
		tabIndex : int Especifica a ordem de tabulação de objetos em um arquivo SWF.	InteractiveObject
		textSnapshot : flash.text:TextSnapshot [somente leitura] Retorna um objeto TextSnapshot para essa ocorrência de DisplayObjectContainer.	DisplayObjectContainer
		transform : flash.geom:Transform Um objeto com propriedades relacionadas aos limites de pixels, matriz e transformação de cores de um objeto de exibição.	DisplayObject
		useHandCursor : Boolean Um valor booliano que indica se a mão que aponta (cursor de mão) aparece quando o ponteiro passa sobre uma entidade gráfica em que a propriedade buttonMode esteja definida como "true".	Sprite
		value : Number Obtém ou define um valor que indica a quantidade de progresso realizado na operação de carregamento.	ProgressBar
		visible : Boolean [substituir] Obtém ou define um valor que indica se a ocorrência do componente atual é visível.	UIComponent
		width : Number [substituir] Obtém ou define a largura do componente, em pixels.	UIComponent
		x : Number [substituir] Obtém ou define a coordenada x que representa a posição do componente ao longo do eixo x em seu contêiner-pai.	UIComponent
		y : Number [substituir] Obtém ou define a coordenada y que representa a posição do componente ao longo do eixo y em seu contêiner-pai.	UIComponent
		z : Number Indica a posição da coordenada z ao longo do eixo z da ocorrência DisplayObject em relação ao contêiner 3D pai.	DisplayObject

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		ProgressBar() Cria uma nova ocorrência do componente ProgressBar.	ProgressBar
		addChild(child:DisplayObject):DisplayObject Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer.	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject Adiciona uma ocorrência-filho de DisplayObject a essa ocorrência de DisplayObjectContainer.	DisplayObjectContainer
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.	EventDispatcher
		areInaccessibleObjectsUnderPoint(point:Point):Boolean Indica se restrições de segurança fariam com que qualquer objeto de exibição fosse omitido da lista retornada com a chamada do método DisplayObjectContainer.getObjectsUnderPoint() junto com o ponto especificado.	DisplayObjectContainer
		clearStyle(style:String):void Exclui uma propriedade de estilo desta ocorrência do componente.	UIComponent
		contains(child:DisplayObject):Boolean Determina se o objeto de exibição especificado é um filho da ocorrência de DisplayObjectContainer ou se é a própria ocorrência.	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean Envia um evento para o fluxo de eventos.	EventDispatcher
		drawFocus(focused:Boolean):void Mostra ou oculta o indicador de foco neste componente.	UIComponent
		drawNow():void Inicia uma operação imediata de desenho, sem invalidar nada como faz invalidateNow.	UIComponent
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace.	DisplayObject
		getChildAt(index:int):DisplayObject Retorna a ocorrência do objeto de exibição-filho que existe no índice especificado.	DisplayObjectContainer
		getChildByName(name:String):DisplayObject Retorna o objeto de exibição-filho que existe com o nome especificado.	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int Retorna a posição de índice de uma ocorrência-filho de DisplayObject.	DisplayObjectContainer
		getFocus():InteractiveObject Recupera o objeto que possui foco no momento.	UIComponent
		getObjectsUnderPoint(point:Point):Array Retorna uma matriz de objetos que estão dispostos no ponto especificado e são filhos (ou netos e assim por diante) desta ocorrência de DisplayObjectContainer.	DisplayObjectContainer
		getRect(targetCoordinateSpace:DisplayObject):Rectangle Retorna um retângulo que define o limite do objeto de exibição, com base no sistema de coordenadas definido pelo parâmetro espaçoCoordenadasDestino, excluindo quaisquer traçados em formas.	DisplayObject
		getStyle(style:String):Object Recupera uma propriedade de estilo definida na cadeia de pesquisa de estilo do componente.	UIComponent
		getStyleDefinition():Object [estático] Recupera o mapa de estilos padrão do componente atual.	ProgressBar
		globalToLocal(point:Point):Point Converte o objeto de ponto a partir de coordenadas de Palco (globais) em coordenadas do objeto de exibição (locais).	DisplayObject
		globalToLocal3D(point:Point):Vector3D Converte um ponto bidimensional das coordenadas do Palco (globais) em coordenadas do objeto de exibição tridimensional (locais).	DisplayObject
		hasEventListener(type:String):Boolean Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		hitTestObject(obj:DisplayObject):Boolean Avalia a caixa delimitadora do objeto de exibição para ver se ela sobrepõe ou faz interseção com a caixa delimitadora do objeto de exibição obj.	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Avalia o objeto de exibição para ver se ele sobrepõe ou faz interseção com o ponto especificado pelos parâmetros x e y.	DisplayObject
		invalidate(property:String, callLater:Boolean = true):void Marca uma propriedade como inválida e redesenha o componente no quadro seguinte, a não ser que especificado de outra forma.	UIComponent
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		local3DToGlobal(point3d:Vector3D):Point Converte um ponto tridimensional das coordenadas (locais) do objeto de exibição tridimensional em ponto bidimensional das coordenadas (globais) do Palco.	DisplayObject
		localToGlobal(point:Point):Point Converte o objeto de ponto a partir das coordenadas do objeto de exibição (locais) em coordenadas do Palco (globais).	DisplayObject
		mergeStyles(... list):Object [estático] Mescla os estilos de várias classes em um objeto.	UIComponent
		move(x:Number, y:Number):void Move o componente até a posição especificada em seu pai.	UIComponent
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		removeChild(child:DisplayObject):DisplayObject Remove uma ocorrência-filho de DisplayObject especificada da lista de filhos da ocorrência de DisplayObjectContainer.	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject Remove um DisplayObject filho da posição de índice especificada na lista de filhos de DisplayObjectContainer.	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void Remove todas as instâncias filho DisplayObject especificadas da lista de filhos da instância DisplayObjectContainer.	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Remove um ouvinte do objeto EventDispatcher.	EventDispatcher
		requestSoftKeyboard():Boolean Ativa um teclado virtual.	InteractiveObject
		reset():void Redefine a barra de progresso para uma nova operação de carregamento.	ProgressBar
		setChildIndex(child:DisplayObject, index:int):void Altera a posição de um filho existente no contêiner de objetos de exibição.	DisplayObjectContainer
		setFocus():void Define o foco para este componente.	UIComponent
		setProgress(value:Number, maximum:Number):void Define o estado da barra para refletir a quantidade de progresso durante o uso do modo manual.	ProgressBar
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		setSize(width:Number, height:Number):void Define o componente para a largura e altura especificadas.	UIComponent
		setStyle(style:String, value:Object):void Define uma propriedade de estilo nesta ocorrência do componente.	UIComponent
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Permite ao usuário arrastar a entidade gráfica especificada.	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void Deixa o usuário arrastar o sprite especificado em um dispositivo ativado pelo toque.	Sprite
		stopAllMovieClips():void Interrompe repetitivamente a execução da linha de tempo de todos os MovieClips enraizados neste objeto.	DisplayObjectContainer
		stopDrag():void Finaliza o método startDrag().	Sprite
		stopTouchDrag(touchPointID:int):void Termina o método startTouchDrag() para o uso com dispositivos ativados pelo toque.	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void Alterna a ordem z (ordem da frente para trás) dos dois objetos filhos especificados.	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void Alterna a ordem z (ordem da frente para trás) dos objetos-filho nas duas posições de índice especificadas na lista de filhos.	DisplayObjectContainer
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Retorna a representação de string do objeto especificado.	Object
		validateNow():void Valida e atualiza as propriedades e o layout deste objeto, redesenhando-o se necessário.	UIComponent
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object
		willTrigger(type:String):Boolean Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.	EventDispatcher

Métodos protegidos

Ocultar métodos protegidos herdados

Mostrar métodos protegidos herdados

	Método		Definido por
		getStyleValue(name:String):Object Retorna o estilo especificado para um componente, considerando todos os estilos definidos nos níveis global, de componente e de ocorrência.	UIComponent

Eventos

Clique para obter mais informações sobre eventos

Ocultar eventos herdados

Mostrar eventos herdados

	Resumo	Definido por
activate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo.	EventDispatcher
added	Despachado quando um objeto de exibição é adicionado à lista de exibição.	DisplayObject
addedToStage	Despachado quando um objeto de exibição é adicionado à lista de exibição no palco, seja diretamente ou através da adição de uma subárvore na qual esse objeto de exibição está contido.	DisplayObject
clear	Despachado quando o usuário seleciona "Clear" (ou "Delete") no menu de contexto do texto.	InteractiveObject
click	Despachado quando um usuário pressiona e solta o botão principal do dispositivo apontador sobre o mesmo InteractiveObject.	InteractiveObject
complete	Despachado quando a operação de carregamento é concluída.	ProgressBar
contextMenu	Despachado quando uma ação do usuário seleciona o menu de contexto associado a esse objeto interativo em um aplicativo do AIR.	InteractiveObject
copy	Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de copiar ou seleciona "Copy" no menu de contexto do texto.	InteractiveObject
cut	Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de cortar ou seleciona "Cut" no menu de contexto do texto.	InteractiveObject
deactivate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo.	EventDispatcher
doubleClick	Despachado quando um usuário pressiona e solta o botão principal de um dispositivo apontador duas vezes em rápida sucessão sobre o mesmo InteractiveObject quando o sinalizador doubleClickEnabled desse objeto está definido como "true".	InteractiveObject
enterFrame	[evento de transmissão] Despachado quando o indicador de reprodução está entrando em um novo quadro.	DisplayObject
exitFrame	[evento de transmissão] Despachado quando o indicador de reprodução está deixando o quadro atual.	DisplayObject
focusIn	Despachado depois que um objeto de exibição ganha foco.	InteractiveObject
focusOut	Despachado depois que um objeto de exibição perde o foco.	InteractiveObject
frameConstructed	[evento de transmissão] Despachado depois que são executados os construtores dos objetos de exibição de quadro, mas antes dos scripts.	DisplayObject
gestureDirectionalTap	Enviado quando um usuário cria um ponto de contato na borda da superfície de toque com uma instância InteractiveObject (como tocar na borda da superfície de toque no Siri Remote da Apple TV). Alguns dispositivos também podem interpretar esse contato como uma combinação de vários eventos de toque.	InteractiveObject
gestureLongPress	Despachado quando o usuário aperta dois pontos de contato na mesma instância InteractiveObject em um dispositivo ativado pelo toque (como pressionar e soltar dois dedos em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
gesturePan	Despachado quando o usuário move um ponto de contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como mover os dedos da esquerda para a direita em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
gestureRotate	Despachado quando o usuário executa uma rotação em um ponto do contato com uma instância InteractiveObject (como tocar com dois dedos e rodá-los em cima de um objeto da tela em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
gestureSwipe	Despachado quando o usuário executa um gesto de arrastar em um ponto de contato com uma instância InteractiveObject (como tocar três dedos em uma tela e depois movê-los em paralelo sobre um objeto de exposição em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
gestureTap	Despachado quando o usuário cria um ponto do contato com uma instância InteractiveObject, depois toca com um dispositivo ativado pelo toque (como colocar vários dedos em um objeto da tela para abrir um menu e depois toca com um dedo para selecionar um item do menu em um celular ou tablet com tela sensível ao toque).	InteractiveObject
gestureZoom	Despachado quando o usuário executa um zoom em um ponto do contato com uma instância InteractiveObject (como tocar dois dedos em uma tela e depois abrir os dedos por cima de um objeto de exposição em um celular ou tablet com uma tela de toque).	InteractiveObject
hide	Despachado depois que a visibilidade do componente muda de visível para invisível.	UIComponent
imeStartComposition	Este evento é despachado para qualquer aplicativo cliente que suporte a entrada incorporada com um IME	InteractiveObject
keyDown	Despachado quando o usuário pressiona uma tecla.	InteractiveObject
keyFocusChange	Despachado quando o usuário tenta alterar o foco usando a navegação pelo teclado.	InteractiveObject
keyUp	Despachado quando o usuário solta uma tecla.	InteractiveObject
middleClick	Despachado quando um usuário pressiona e libera o botão do meio do dispositivo apontador sobre o mesmo InteractiveObject.	InteractiveObject
middleMouseDown	Despachado quando o usuário pressiona o botão do meio do dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
middleMouseUp	Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
mouseDown	Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
mouseFocusChange	Despachado quando o usuário tenta alterar o foco usando um dispositivo apontador.	InteractiveObject
mouseMove	Despachado quando um usuário move o dispositivo apontador enquanto ele está sobre InteractiveObject.	InteractiveObject
mouseOut	Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject.	InteractiveObject
mouseOver	Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
mouseUp	Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
mouseWheel	Despachado quando a roda do mouse rola sobre uma ocorrência InteractiveObject.	InteractiveObject
move	Despachado após a movimentação do componente.	UIComponent
nativeDragComplete	Despachado pelo iniciador de arrasto InteractiveObject quando o usuário libera o gesto de arrastar.	InteractiveObject
nativeDragDrop	Despachado pelo InteractiveObject de destino quando um objeto arrastado é solto nele e a liberação tiver sido aceita com uma chamada para DragManager.acceptDragDrop().	InteractiveObject
nativeDragEnter	Despachado por um InteractiveObject quando o gesto de arrasto entra no respectivo limite.	InteractiveObject
nativeDragExit	Despachado por um InteractiveObject quando o gesto de arrasto deixa o respectivo limite.	InteractiveObject
nativeDragOver	Despachado continuamente por um InteractiveObject enquanto o gesto de arrasto permanecer dentro do respectivo limite.	InteractiveObject
nativeDragStart	Despachado no início de uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag().	InteractiveObject
nativeDragUpdate	Despachado durante uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag().	InteractiveObject
paste	Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de colar ou seleciona "Paste" no menu de contexto do texto.	InteractiveObject
progress	Despachado à medida que o conteúdo é carregado no modo de evento ou no modo em poll.	ProgressBar
proximityBegin	Despachado quando o usuário abaixa um estilo ativo para além do limite de detecção de proximidade da tela.	InteractiveObject
proximityEnd	Despachado quando o usuário levanta um estilo ativo acima do limite de detecção de proximidade da tela.	InteractiveObject
proximityMove	Despachado quando o usuário move um estilo ativo sobre a tela enquanto permanece dentro do limite de detecção de proximidade.	InteractiveObject
proximityOut	Despachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela.	InteractiveObject
proximityOver	Despachado quando o usuário move um estilo ativo diretamente acima deste InteractiveObject enquanto permanece dentro do limite de detecção de proximidade da tela.	InteractiveObject
proximityRollOut	Despachado quando o usuário move um estilo ativo deste InteractiveObject e algum de seus filhos enquanto permanece dentro do limite de detecção de proximidade da tela.	InteractiveObject
proximityRollOver	Despachado quando o usuário move um estilo ativo sobre este InteractiveObject do exterior da árvore do objeto de descendentes na lista de exibição (enquanto permanece dentro do limite de detecção de proximidade da tela).	InteractiveObject
releaseOutside	Enviado quando um usuário solta o botão no dispositivo apontador depois que o usuário primeiro pressionou o botão sobre uma instância de InteractiveObject e moveu o dispositivo apontador de da instância para fora do InteractiveObject.	InteractiveObject
removed	Despachado quando um objeto de exibição está prestes a ser removido da lista de exibição.	DisplayObject
removedFromStage	Despachado quando um objeto de exibição está prestes a ser removido da lista de exibição, seja diretamente ou através da remoção de uma subárvore na qual esse objeto de exibição está contido.	DisplayObject
render	[evento de transmissão] Despachado quando a lista de exibição está prestes a ser atualizada e renderizada.	DisplayObject
resize	Despachado após o redimensionamento do componente.	UIComponent
rightClick	Despachado quando um usuário pressiona e libera o botão direito do dispositivo apontador sobre o mesmo InteractiveObject.	InteractiveObject
rightMouseDown	Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
rightMouseUp	Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
rollOut	Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject.	InteractiveObject
rollOver	Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject.	InteractiveObject
selectAll	Despachado quando o usuário ativa a combinação de teclas do acelerador específica da plataforma para uma operação de selecionar tudo ou seleciona "Select All" no menu de contexto do texto.	InteractiveObject
show	Despachado depois que a visibilidade do componente muda de invisível para visível.	UIComponent
softKeyboardActivate	Despachado imediatamente depois que o teclado virtual é elevado.	InteractiveObject
softKeyboardActivating	Despachado imediatamente antes de o teclado virtual ser elevado.	InteractiveObject
softKeyboardDeactivate	Despachado imediatamente depois que o teclado virtual é baixado.	InteractiveObject
tabChildrenChange	Despachado quando o valor do sinalizador tabChildren do objeto é alterado.	InteractiveObject
tabEnabledChange	Despachado quando o sinalizador tabEnabled do objeto é alterado.	InteractiveObject
tabIndexChange	Despachado quando o valor da propriedade tabIndex do objeto é alterado.	InteractiveObject
textInput	Despachado quando um usuário introduz um ou vários caracteres do texto.	InteractiveObject
touchBegin	Despachado quando o usuário entra em contato pela primeira vez com um dispositivo ativado pelo toque (como tocar com um dedo um celular ou tablet com uma tela sensível toque).	InteractiveObject
touchEnd	Despachado quando o usuário remove o contato com um dispositivo ativado pelo toque (como retirar o dedo de um celular ou tablet com uma tela de toque).	InteractiveObject
touchMove	Despachado quando o usuário toca o dispositivo, e é despachado continuamente até que o ponto contato seja removido.	InteractiveObject
touchOut	Despachado quando o usuário move o ponto do contato longe da instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para outro em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
touchOver	Despachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
touchRollOut	Despachado quando o usuário move o ponto do contato longe de uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um objeto da tela para um ponto fora do objeto da tela em um celular ou tablet com uma tela sensível toque).	InteractiveObject
touchRollOver	Despachado quando o usuário move o ponto do contato em uma instância InteractiveObject em um dispositivo ativado pelo toque (como arrastar um dedo de um ponto fora de um objeto da tela a um ponto em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject
touchTap	Despachado quando o usuário levanta o ponto do contato na mesma instância InteractiveObject em que o contato foi iniciado em um dispositivo ativado pelo toque (como pressionar e soltar com o dedo um ponto único em um objeto da tela em um celular ou tablet com uma tela sensível ao toque).	InteractiveObject

Estilos

Os estilos são comuns ou associados a um tema específico. Se o estilo for comum, poderá ser usado com qualquer tema. Se o estilo for associado a um tema específico, só poderá ser usado se o seu aplicativo usar esse tema.

Estilos comuns

Clique para obter mais informações sobre estilos

Ocultar estilos herdados

Mostrar estilos herdados

	Descrição	Definido por
barPadding	Tipo: Number Formato: Length Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O preenchimento que separa o indicador da barra de progresso da faixa, em pixels. O valor padrão é `0`.	ProgressBar
barSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como barra de progresso determinada. O valor padrão é `ProgressBar_barSkin`.	ProgressBar
disabledTextFormat	Tipo: flash.text.TextFormat Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O objeto TextFormat a ser usado para renderizar o rótulo do componente quando o botão é desabilitado.	UIComponent
focusRectPadding	Tipo: Number Formato: Length Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O preenchimento que separa os limites externos do componente das arestas externas do indicador de foco, em pixels.	UIComponent
focusRectSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A capa a ser usada para exibir indicadores de foco.	UIComponent
icon	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como ícone padrão. A definição de qualquer outro estilo de ícone substitui essa definição. O valor padrão é `null`.	ProgressBar
indeterminateBar	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 A classe a ser usada como um renderizador para a animação da barra indeterminada. Esse é um estilo avançado. O valor padrão é `fl.controls.progressBarClasses.IndeterminateBar`.	ProgressBar
indeterminateSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como barra de progresso indeterminada. É passado a um renderizador de barra indeterminada, que é especificado pelo estilo `indeterminateBar`. O valor padrão é `ProgressBar_indeterminateSkin`.	ProgressBar
textFormat	Tipo: flash.text.TextFormat Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 O objeto TextFormat a ser usado para renderizar o rótulo do componente.	UIComponent
trackSkin	Tipo: Class Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Nome da classe a ser usada como faixa indicadora de progresso. O valor padrão é `ProgressBar_trackSkin`.	ProgressBar

Constantes públicas

Ocultar constantes públicas herdadas

Mostrar constantes públicas herdadas

	Constante		Definido por
		version : String = "3.0.3.1" O número de versão dos componentes.	UIComponent

Detalhes da propriedade

direction

propriedade

direction:String

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Indica a direção de preenchimento da barra de progresso. Um valor de ProgressBarDirection.RIGHT indica que a barra de progresso é preenchida da esquerda para a direita. Um valor de ProgressBarDirection.LEFT indica que a barra de progresso é preenchida da direita para a esquerda.

O valor padrão é ProgressBarDirection.RIGHT.

Implementação
public function get direction():String
public function set direction(value:String):void

Elementos da API relacionados

ProgressBarDirection

Exemplo ( Como usar este exemplo )

O exemplo a seguir exibe a diferença entre uma barra de progresso que é carregada a partir da esquerda e uma barra de progresso que é carregada a partir da direita. Substitua testPath por um arquivo grande para testar localmente:

 
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

propriedade

indeterminate:Boolean

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Obtém ou define um valor que indica o tipo de preenchimento que a barra de progresso utiliza e se a fonte de carregamento é conhecida ou desconhecida. Um valor true indica que a barra de progresso tem um preenchimento listrado e uma fonte de carregamento de tamanho desconhecido. Um valor de false indica que a barra de progresso tem um preenchimento sólido e uma fonte de carregamento de tamanho conhecido.

Essa propriedade pode ser definida apenas quando o modo da barra de progresso é definido como ProgressBarMode.MANUAL.

O valor padrão é true.

Implementação
public function get indeterminate():Boolean
public function set indeterminate(value:Boolean):void

Elementos da API relacionados

modo
ProgressBarMode
IndeterminateBar

maximum

propriedade

maximum:Number

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Obtém ou define o valor máximo para a barra de progresso quando a propriedade ProgressBar.mode é definida como ProgressBarMode.MANUAL.

O valor padrão é 0.

Implementação
public function get maximum():Number
public function set maximum(value:Number):void

Elementos da API relacionados

mínimo
percentComplete
valor
ProgressBarMode.MANUAL

minimum

propriedade

minimum:Number

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Obtém ou define o valor mínimo da barra de progresso quando a propriedade ProgressBar.mode é definida como ProgressBarMode.MANUAL.

O valor padrão é 0.

Implementação
public function get minimum():Number
public function set minimum(value:Number):void

Elementos da API relacionados

maximum
percentComplete
valor
ProgressBarMode.MANUAL

mode

propriedade

mode:String

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Obtém ou define o método a ser usado para atualizar a barra de progresso.

Os valores a seguir são válidos para essa propriedade:

ProgressBarMode.EVENT
ProgressBarMode.POLLED
ProgressBarMode.MANUAL

O modo de evento e o modo em poll são os modos mais comuns. No modo de evento, a propriedade source especifica o conteúdo de carregamento que gera os eventos de progresso e conclusão; é recomendável usar um objeto UILoader nesse modo. No modo em poll, a propriedade source especifica o conteúdo de carregamento que expõe as propriedades bytesLoaded e bytesTotal. Qualquer objeto que expõe essas propriedades pode ser utilizado como uma origem no modo em poll.

É possível também usar o componente ProgressBar em modo manual definindo manualmente as propriedades maximum e minimum e fazendo chamadas ao método ProgressBar.setProgress().

O valor padrão é ProgressBarMode.EVENT.

Implementação
public function get mode():String
public function set mode(value:String):void

Elementos da API relacionados

ProgressBarMode

percentComplete

propriedade

percentComplete:Number [somente leitura]

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Obtém um número entre 0 e 100 que indica a porcentagem do conteúdo já carregada.

Para alterar o valor percentual, use o método setProgress().

O valor padrão é 0.

Implementação
public function get percentComplete():Number

Elementos da API relacionados

maximum
mínimo
setProgress()
valor

Exemplo ( Como usar este exemplo )

O exemplo a seguir cria ocorrências dos componentes ProgressBar e Label para exibir o status da barra de progresso:


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) + "%)";
}

O exemplo a seguir demonstra como monitorar o progresso de carregamento acessando a propriedade percentLoaded. É necessário primeiro definir a variável dataPath como um arquivo 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

propriedade

source:Object

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Obtém ou define uma referência ao conteúdo que está sendo carregado e para o qual ProgressBar está medindo o progresso da operação de carregamento. Um uso típico dessa propriedade é defini-la como um componente UILoader.

Use essa propriedade apenas no modo de evento e no modo em poll.

O valor padrão é null.

Implementação
public function get source():Object
public function set source(value:Object):void

Exemplo ( Como usar este exemplo )

O exemplo a seguir demonstra como vincular uma barra de progresso a um carregador definindo a propriedade source. Para que a barra de progresso mostre o progresso do carregamento, a variável dataPath deve ser definida primeiro como um arquivo 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);

O exemplo a seguir define a propriedade source para uma barra de progresso para um painel de rolagem:


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

propriedade

value:Number

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Obtém ou define um valor que indica a quantidade de progresso realizado na operação de carregamento. Esse valor é um número entre os valores minimum e maximum.

O valor padrão é 0.

Implementação
public function get value():Number
public function set value(value:Number):void

Elementos da API relacionados

maximum
mínimo
percentComplete

Detalhes do construtor

()

Construtor

public function ProgressBar()

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Cria uma nova ocorrência do componente ProgressBar.

Detalhes do método

getStyleDefinition

()

método

public static function getStyleDefinition():Object

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Recupera o mapa de estilos padrão do componente atual. O mapa de estilos contém o tipo que é apropriado para o componente, de acordo com o estilo que o componente usa. Por exemplo, o estilo disabledTextFormat contém o valor null ou um objeto TextFormat. Você pode usar estes estilos e chamar setStyle() no componente atual. O código a seguir substitui o estilo disabledTextFormat padrão no componente especificado:

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

Retorna

Object — Objeto de estilos padrão.

Elementos da API relacionados

fl.core.UIComponent.getStyle()
fl.core.UIComponent.setStyle()
fl.managers.StyleManager

Exemplo ( Como usar este exemplo )

O exemplo a seguir cria um navegador de estilo para várias classes 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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Redefine a barra de progresso para uma nova operação de carregamento.

setProgress

()

método

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

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Define o estado da barra para refletir a quantidade de progresso durante o uso do modo manual. O argumento value é atribuído à propriedade value, e o argumento maximum é atribuído à propriedade maximum. A propriedade minimum não é alterada.

Parâmetros

	`value:Number` — Um valor que descreve o progresso realizado.

	`maximum:Number` — O valor máximo de progresso da barra de progresso.

Elementos da API relacionados

maximum
valor
ProgressBarMode.manual

Detalhe do evento

complete

Evento

Tipo do objeto de evento: flash.events.Event
propriedade Event.type = flash.events.Event.COMPLETE

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Despachado quando a operação de carregamento é concluída.

A constante Event.COMPLETE define o valor da propriedade type de um objeto de evento complete.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`target`	O objeto de rede que concluiu o carregamento.

Exemplo ( Como usar este exemplo )

O exemplo a seguir carrega uma imagem externa usando um componente UILoader, e quando o carregamento da imagem é concluído, os componentes ProgressBar e Label ficam ocultos:


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 do objeto de evento: flash.events.ProgressEvent
propriedade ProgressEvent.type = flash.events.ProgressEvent.PROGRESS

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flash CS3

Versões de runtime:

Flash Player 9.0.28.0, AIR 1.0

Despachado à medida que o conteúdo é carregado no modo de evento ou no modo em poll.

Define o valor da propriedade type de um objeto de evento progress.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`bytesLoaded`	O número de itens ou bytes carregados no momento em que o ouvinte processa o evento.
`bytesTotal`	O número total de itens ou bytes que serão carregados no final se o processo de carregamento tiver êxito.
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`target`	O objeto que está informando o andamento.

Exemplo ( Como usar este exemplo )

O exemplo a seguir carrega uma imagem externa usando um componente UILoader, e quando o carregamento da imagem é concluído, os componentes ProgressBar e Label ficam ocultos:


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

Elementos da API relacionados

ProgressBarMode.EVENT
ProgressBarMode.POLLED

Exemplos Como usar este exemplo

ProgressBarExample.as

Este exemplo demonstra como incrementar manualmente uma ProgressBar

Adicione os componentes ProgressBar, Label e Button à biblioteca.
Salve esse código como ProgressBarExample.as no mesmo diretório de FLA.
Defina DocumentClass em FLA como ProgressBarExample.

package
{
    import flash.display.Sprite;
    import flash.events.MouseEvent;
    import fl.controls.ProgressBar;
    import fl.controls.ProgressBarMode;
    import fl.controls.Button;
    
    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.mode = ProgressBarMode.MANUAL;
            pb.move(10,10);
            addChild(pb);
        }
    }
}

Aspectos jurídicos | Política de privacidade on-line

ProgressBar - AS3 Flash

Classes x

direction

indeterminate

maximum

minimum

mode

percentComplete

source

value

ProgressBar

getStyleDefinition

reset

setProgress

complete

progress