Button

Pacote	fl.controls
Classe	public class Button
Herança	Button LabelButton BaseButton UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
Implementações	IFocusManagerComponent

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 Button representa um botão retangular comumente utilizado. Os componentes Button exibem um rótulo de texto, um ícone ou ambos.

Um componente Button está normalmente associado a um método de tratamento de eventos que ouve um evento click e realiza a tarefa especificada, depois do envio do evento click. Quando o usuário clica em um botão ativado, o botão envia os eventos clique and buttonDown. Mesmo quando está desativado, o botão envia outros eventos, incluindo mouseMove, mouseOver, mouseOut, rollOver, rollOut, mouseDown e mouseUp.

É possível alterar a aparência do botão associando-se a uma capa diferente a cada estado de botão. Um componente Button também pode ser definido para funcionar como um botão de ação ou um botão de alternância.

Veja os exemplos

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
		autoRepeat : Boolean Obtém ou define um valor booliano que indica se o evento buttonDown é despachado mais de uma vez quando o usuário mantém o botão do mouse pressionado sobre o componente.	BaseButton
		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
		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
		emphasized : Boolean Obtém ou define um valor booliano que indica se uma borda é desenhada ao redor do componente Button quando o botão está no estado ativo.	Button
		enabled : Boolean [substituir] Obtém ou define um valor que indica se o componente pode aceitar a entrada do usuário.	BaseButton
		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
		label : String Obtém ou define o rótulo de texto do componente.	LabelButton
		labelPlacement : String Posição do rótulo em relação a um ícone especificado.	LabelButton
		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
		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
		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
		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
		selected : Boolean [substituir] Obtém ou define um valor booliano que indica se um botão de alternância está na posição ativado ou desativado.	LabelButton
		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
		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
		textField : flash.text:TextField Uma referência ao campo de texto interno do componente.	LabelButton
		textSnapshot : flash.text:TextSnapshot [somente leitura] Retorna um objeto TextSnapshot para essa ocorrência de DisplayObjectContainer.	DisplayObjectContainer
		toggle : Boolean Obtém ou define um valor booliano que indica se um botão pode ser alternado.	LabelButton
		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
		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
		Button() Cria uma nova ocorrência do componente Button.	Button
		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.	Button
		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
		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
		setMouseState(state:String):void Define o estado do mouse via ActionScript.	BaseButton
		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
buttonDown	Despachado quando o usuário pressiona o componente Button.	BaseButton
change	Despachado quando é alterado o valor da propriedade selecionada de um componente de botão de alternância.	BaseButton
clear	Despachado quando o usuário seleciona "Clear" (ou "Delete") no menu de contexto do texto.	InteractiveObject
click	Despachado depois que o botão de alternância recebe entrada de um dispositivo de mouse ou da barra de espaços.	LabelButton
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
labelChange	Despachado depois que o valor do rótulo é alterado.	LabelButton
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
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
disabledIcon	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 O nome da classe a ser usando como o ícone quando o botão estiver desativado.	LabelButton
disabledSkin	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 usado como capa para o plano de fundo e a borda, quando um botão não está selecionado e está desativado.	LabelButton
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
downIcon	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 usado como o ícone quando o botão não está selecionado e o botão do mouse está pressionado.	LabelButton
downSkin	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 usado como capa para o plano de fundo e a borda, quando um botão não está selecionado e o botão do mouse está pressionado.	LabelButton
embedFonts	Tipo: Boolean Versão da linguagem: ActionScript 3.0 Versão de produto: Flash CS3 Versões de runtime: Flash9.0.28.0, AIR 1.0 Indica se os contornos de fonte incorporados são usados para renderizar o campo de texto.	LabelButton
emphasizedPadding	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 a ser aplicado em torno dos botões em uma capa enfatizada, em pixels. O valor padrão é `2`.	Button
emphasizedSkin	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 quando um botão tem ênfase. O valor padrão é `Button_emphasizedSkin`.	Button
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 usado como o ícone quando um botão de alternância não está selecionado e o mouse não está sobre o botão.	LabelButton
overIcon	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 usado como o ícone quando o botão não está selecionado e o mouse está sobre o componente.	LabelButton
overSkin	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 usado como capa para o plano de fundo e a borda, quando o botão não está selecionado e o mouse está sobre o componente.	LabelButton
repeatDelay	Tipo: Number Formato: Time 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 número de milissegundos a aguardar depois que o evento `buttonDown` é despachado pela primeira vez, antes do envio de um segundo evento `buttonDown`.	LabelButton
repeatInterval	Tipo: Number Formato: Time 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 intervalo, em milissegundos, entre os eventos `buttonDown` despachados depois do atraso especificado pelo estilo `repeatDelay`.	LabelButton
selectedDisabledIcon	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 usado como o ícone quando o botão está selecionado e desativado.	LabelButton
selectedDisabledSkin	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 usado como capa para o plano de fundo e a borda, quando um botão de alternância está selecionado e desativado.	LabelButton
selectedDownIcon	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 usado como o ícone quando o botão está selecionado e o botão do mouse está pressionado.	LabelButton
selectedDownSkin	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 usado como capa para o plano de fundo e a borda, quando um botão de alternância está selecionado e botão do mouse está pressionado.	LabelButton
selectedOverIcon	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 usado como o ícone quando o botão está selecionado e o mouse está sobre o componente.	LabelButton
selectedOverSkin	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 usado como capa para o plano de fundo e a borda, quando um botão de alternância está selecionado e o mouse está sobre o componente.	LabelButton
selectedUpIcon	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 usado como o ícone quando o botão está selecionado e o botão do mouse está solto.	LabelButton
selectedUpSkin	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 usado como capa para o plano de fundo e a borda, quando um botão de alternância está selecionado e o mouse não está sobre o componente.	LabelButton
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
textPadding	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 espaçamento entre o texto e as bordas do componente, e o espaçamento entre o texto e o ícone, em pixels.	LabelButton
upIcon	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 usado como o ícone quando um botão de alternância não está selecionado e o mouse não está sobre o botão.	LabelButton
upSkin	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 usado como capa para o plano de fundo e a borda, quando o botão não está selecionado e o mouse não está sobre o componente.	LabelButton

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

emphasized

propriedade

emphasized: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 booliano que indica se uma borda é desenhada ao redor do componente Button quando o botão está no estado ativo. Um valor true indica que o botão é circundado por uma borda quando está em seu estado para cima; um valor false indica que indica que ele não é circundado por uma borda nesse estado.

O valor padrão é false.

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

Elementos da API relacionados

emphasizedPadding
emphasizedSkin

Exemplo ( Como usar este exemplo )

O exemplo a seguir define o estilo de emphasizedPadding da ocorrência Button, com base no valor do componente Slider:


import fl.controls.Button;
import fl.controls.Slider;
import fl.events.SliderEvent;

var styleObject:Object = Button.getStyleDefinition();
var defaultEmphasizedPadding:uint = styleObject.emphasizedPadding;

var myButton:Button = new Button();
myButton.label = "emphasizedPadding:" + defaultEmphasizedPadding;
myButton.emphasized = true;
myButton.width = 150;
myButton.move(20, 20);
addChild(myButton);

var mySlider:Slider = new Slider();
mySlider.snapInterval = 1;
mySlider.tickInterval = 1;
mySlider.liveDragging = true;
mySlider.value = defaultEmphasizedPadding;
mySlider.width = myButton.width;
mySlider.move(20, 60);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

function changeHandler(event:SliderEvent):void {
    myButton.label = "emphasizedPadding:" + event.value;
    myButton.setStyle("emphasizedPadding", event.value);
}

Detalhes do construtor

()

Construtor

public function Button()

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

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

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

Exemplos Como usar este exemplo

ButtonExample.as

Este exemplo demonstra como criar botões e definir seus estilos dinamicamente.

Adicione Button à biblioteca.
Salve esse código como ButtonExample.as no mesmo diretório de FLA.
Defina DocumentClass em FLA como ButtonExample.

package
{
    import flash.display.MovieClip;
    import flash.events.MouseEvent;
    import flash.text.TextField;
    import flash.text.TextFormat;
    import fl.controls.Button;
    
    public class ButtonExample extends MovieClip
    {
        private var b1:Button;
        private var b2:Button;        
        private var b3:Button;
        private var tf:TextField;
        
        public function ButtonExample() {
            createTraceField();
            setupButtons();
        }
        private function createTraceField():void {
            tf = new TextField();
            tf.width = 200;
            tf.height = 400;
            tf.x = 200;
            tf.y = 10;
            addChild(tf);
        }
        private function setupButtons():void {
            b1 = new Button();
            b2 = new Button();
            b3 = new Button();

            b1.move(10,10);
            b2.move(10,40);
            b3.move(10,70);

            b1.label = "Default Button";
            b2.label = "Custom Styled Button";
            b3.label = "Toggleable Button";
            b2.setStyle("textFormat", new TextFormat("Georgia"));
            b3.width = 120;
            b3.toggle = true;
            
            b1.addEventListener(MouseEvent.CLICK,buttonClick);
            b2.addEventListener(MouseEvent.CLICK,buttonClick);
            b3.addEventListener(MouseEvent.CLICK,buttonClick);

            addChild(b1);
            addChild(b2);
            addChild(b3);
        }
        private function buttonClick(e:MouseEvent) {
            var button:Button = Button(e.target);
            tf.appendText(button.label + "\n");
        }
    }
}

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

Button - AS3 Flash

Classes x

emphasized

Button

getStyleDefinition