| Pacote | flash.display |
| Classe | public class InteractiveObject |
| Herança | InteractiveObject  DisplayObject EventDispatcher Object |
| Subclasses | DisplayObjectContainer, SimpleButton, TextField |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Não é possível instanciar a classe InteractiveObject diretamente. Uma chamada ao construtor new InteractiveObject() lança uma exceção ArgumentError.
A classe InteractiveObject propriamente dita não inclui APIs para a renderização do conteúdo na tela. Para criar uma subclasse personalizada da classe InteractiveObject, estenda uma das subclasses que tenha APIs para aplicar acabamento de conteúdo na tela, como classes Sprite, SimpleButton, TextField, ou MovieClip.
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 | |
| 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 | ||
| filters : Array
Uma matriz indexada que contém cada objeto de filtro atualmente associado ao objeto de exibição. | DisplayObject | |
| focusRect : Object
Especifica se este objeto exibe um retângulo de foco. | InteractiveObject | ||
| height : Number
Indica a altura do objeto de exibição, em pixels. | DisplayObject | |
| 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 | |
| mouseEnabled : Boolean
Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários. | InteractiveObject | ||
| 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 | ||
| 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
Indica a escala horizontal (porcentagem) do objeto aplicada a partir do ponto de registro. | DisplayObject | |
| scaleY : Number
Indica a escala vertical (porcentagem) de um objeto aplicada a partir do ponto de registro desse objeto. | DisplayObject | |
| 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 | ||
| stage : Stage [somente leitura]
O Palco do objeto de exibição. | DisplayObject | |
| 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 | ||
| 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 | |
| visible : Boolean
Se o objeto de exibição está ou não visível. | DisplayObject | |
| width : Number
Indica a largura do objeto de exibição, em pixels. | DisplayObject | |
| x : Number
Indica a coordenada x da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. | DisplayObject | |
| y : Number
Indica a coordenada y da ocorrência de DisplayObject com relação às coordenadas locais do DisplayObjectContainer-pai. | DisplayObject | |
| 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étodo | Definido por | ||
|---|---|---|---|
Chamar o construtor InteractiveObject() lança uma exceção ArgumentError. | InteractiveObject | ||
| 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 | |
|
Envia um evento para o fluxo de eventos. | EventDispatcher | |
|
Retorna um retângulo que define a área do objeto de exibição com relação ao sistema de coordenadas do objeto targetCoordinateSpace. | DisplayObject | |
|
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 | |
|
Converte o objeto de ponto a partir de coordenadas de Palco (globais) em coordenadas do objeto de exibição (locais). | DisplayObject | |
|
Converte um ponto bidimensional das coordenadas do Palco (globais) em coordenadas do objeto de exibição tridimensional (locais). | DisplayObject | |
|
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
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 | |
|
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 | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Converte um ponto tridimensional das coordenadas (locais) do objeto de exibição tridimensional em ponto bidimensional das coordenadas (globais) do Palco. | DisplayObject | |
|
Converte o objeto de ponto a partir das coordenadas do objeto de exibição (locais) em coordenadas do Palco (globais). | DisplayObject | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | |
Ativa um teclado virtual. | InteractiveObject | ||
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna a representação de string do objeto especificado. | Object | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
|
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 | |
| Evento | Resumo | Definido por | ||
|---|---|---|---|---|
| [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 | ||
| Despachado quando um objeto de exibição é adicionado à lista de exibição. | DisplayObject | ||
| 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 | ||
| Despachado quando o usuário seleciona "Clear" (ou "Delete") no menu de contexto do texto. | InteractiveObject | |||
| Despachado quando um usuário pressiona e solta o botão principal do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | |||
| Despachado quando uma ação do usuário seleciona o menu de contexto associado a esse objeto interativo em um aplicativo do AIR. | InteractiveObject | |||
| 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 | |||
| 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 | |||
| [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 | ||
| 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 | |||
| [evento de transmissão] Despachado quando o indicador de reprodução está entrando em um novo quadro. | DisplayObject | ||
| [evento de transmissão] Despachado quando o indicador de reprodução está deixando o quadro atual. | DisplayObject | ||
| Despachado depois que um objeto de exibição ganha foco. | InteractiveObject | |||
| Despachado depois que um objeto de exibição perde o foco. | InteractiveObject | |||
| [evento de transmissão] Despachado depois que são executados os construtores dos objetos de exibição de quadro, mas antes dos scripts. | DisplayObject | ||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| Este evento é despachado para qualquer aplicativo cliente que suporte a entrada incorporada com um IME | InteractiveObject | |||
| Despachado quando o usuário pressiona uma tecla. | InteractiveObject | |||
| Despachado quando o usuário tenta alterar o foco usando a navegação pelo teclado. | InteractiveObject | |||
| Despachado quando o usuário solta uma tecla. | InteractiveObject | |||
| Despachado quando um usuário pressiona e libera o botão do meio do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | |||
| Despachado quando o usuário pressiona o botão do meio do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
| Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
| Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
| Despachado quando o usuário tenta alterar o foco usando um dispositivo apontador. | InteractiveObject | |||
| Despachado quando um usuário move o dispositivo apontador enquanto ele está sobre InteractiveObject. | InteractiveObject | |||
| Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject. | InteractiveObject | |||
| Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
| Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
| Despachado quando a roda do mouse rola sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
| Despachado pelo iniciador de arrasto InteractiveObject quando o usuário libera o gesto de arrastar. | InteractiveObject | |||
| 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 | |||
| Despachado por um InteractiveObject quando o gesto de arrasto entra no respectivo limite. | InteractiveObject | |||
| Despachado por um InteractiveObject quando o gesto de arrasto deixa o respectivo limite. | InteractiveObject | |||
| Despachado continuamente por um InteractiveObject enquanto o gesto de arrasto permanecer dentro do respectivo limite. | InteractiveObject | |||
| Despachado no início de uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag(). | InteractiveObject | |||
| Despachado durante uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag(). | InteractiveObject | |||
| 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 | |||
| Despachado quando o usuário abaixa um estilo ativo para além do limite de detecção de proximidade da tela. | InteractiveObject | |||
| Despachado quando o usuário levanta um estilo ativo acima do limite de detecção de proximidade da tela. | InteractiveObject | |||
| Despachado quando o usuário move um estilo ativo sobre a tela enquanto permanece dentro do limite de detecção de proximidade. | InteractiveObject | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| Despachado quando um objeto de exibição está prestes a ser removido da lista de exibição. | DisplayObject | ||
| 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 | ||
| [evento de transmissão] Despachado quando a lista de exibição está prestes a ser atualizada e renderizada. | DisplayObject | ||
| Despachado quando um usuário pressiona e libera o botão direito do dispositivo apontador sobre o mesmo InteractiveObject. | InteractiveObject | |||
| Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
| Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
| Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject. | InteractiveObject | |||
| Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject. | InteractiveObject | |||
| 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 | |||
| Despachado imediatamente depois que o teclado virtual é elevado. | InteractiveObject | |||
| Despachado imediatamente antes de o teclado virtual ser elevado. | InteractiveObject | |||
| Despachado imediatamente depois que o teclado virtual é baixado. | InteractiveObject | |||
| Despachado quando o valor do sinalizador tabChildren do objeto é alterado. | InteractiveObject | |||
| Despachado quando o sinalizador tabEnabled do objeto é alterado. | InteractiveObject | |||
| Despachado quando o valor da propriedade tabIndex do objeto é alterado. | InteractiveObject | |||
| Despachado quando um usuário introduz um ou vários caracteres do texto. | InteractiveObject | |||
| 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 | |||
| 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 | |||
| Despachado quando o usuário toca o dispositivo, e é despachado continuamente até que o ponto contato seja removido. | InteractiveObject | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
accessibilityImplementation | propriedade |
accessibilityImplementation:AccessibilityImplementation| Versão da linguagem: | ActionScript 3.0 |
A implementação de acessibilidade atual (AccessibilityImplementation) para esta instância do InteractiveObject.
Implementação
public function get accessibilityImplementation():AccessibilityImplementation public function set accessibilityImplementation(value:AccessibilityImplementation):voidElementos da API relacionados
contextMenu | propriedade |
contextMenu:NativeMenu| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica o menu de contexto associado a este objeto.
Para conteúdo em execução no Flash Player, esta propriedade é um objeto ContextMenu. No tempo de execução do AIR, a classe ContextMenu amplia a classe NativeMenu; no entanto, o Flash Player suporta apenas a classe ContextMenu e não a classe NativeMenu.
Observação: Os objetos de TextField sempre incluem um menu de área de transferência no menu de contexto. O menu de área de transferência contém os comandos Recortar, Copiar, Colar, Apagar e Selecionar tudo. Você não pode remover estes comandos do menu de contexto de objetos TextField. Para objetos TextField, selecionar estes comandos (ou os seus equivalentes de teclado) não gera eventos clear, copy, cut, paste, ou selectAll.
Implementação
public function get contextMenu():NativeMenu public function set contextMenu(value:NativeMenu):voidExemplo ( Como usar este exemplo )
var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
spr.graphics.clear();
spr.graphics.beginFill(0xFF0000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
}
doubleClickEnabled | propriedade |
doubleClickEnabled:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9 |
Especifica se o objeto recebe eventos doubleClick. O valor padrão é false, o que significa que, por padrão, qualquer ocorrência de InteractiveObject não recebe eventos doubleClick. Se a propriedade doubleClickEnabled estiver definida como true, a ocorrência receberá eventos doubleClick dentro de seus limites. A propriedade mouseEnabled da ocorrência de InteractiveObject também deve ser definida como true para que o objeto receba eventos doubleClick.
Nenhum evento é despachado com o uso dessa propriedade. Você deve usar o método addEventListener() para adicionar um ouvinte de evento para o evento doubleClick.
Implementação
public function get doubleClickEnabled():Boolean public function set doubleClickEnabled(value:Boolean):voidElementos da API relacionados
focusRect | propriedade |
focusRect:Object| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica se este objeto exibe um retângulo de foco. Pode ser um dos três valores: true, false ou null. Os valores de true e false funcionam como esperado, especificando se o retângulo de foco aparece ou não. Um valor null indica que esse objeto obedece à propriedade stageFocusRect no Palco.
Implementação
public function get focusRect():Object public function set focusRect(value:Object):voidmouseEnabled | propriedade |
mouseEnabled:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica se este objeto recebe mensagens de mouse, ou de outras entradas de usuários. O valor padrão é true, o que significa que, por padrão, qualquer instância de InteractiveObject na lista de exibição receberá eventos do mouse. Se mouseEnabled for definido como false, a instância não recebe nenhum evento de mouse (ou outros eventos de entrada de usuário como eventos do teclado). Nenhum filho dessa ocorrência na lista de exibição será afetado. Para alterar o comportamento de mouseEnabled para todos os filhos de um objeto na lista de objetos, use flash.display.DisplayObjectContainer.mouseChildren.
Nenhum evento é despachado com o uso dessa propriedade. É necessário usar o método addEventListener() para criar uma funcionalidade interativa.
Implementação
public function get mouseEnabled():Boolean public function set mouseEnabled(value:Boolean):voidElementos da API relacionados
needsSoftKeyboard | propriedade |
needsSoftKeyboard:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.2, AIR 2.6 |
Especifica se um teclado virtual (teclado de software, na tela) deve ser exibido quando esta instância InteractiveObject recebe foco.
Por padrão, o valor é false e a focalização de uma instância InteractiveObject não ativa um teclado virtual. Se a propriedade needsSoftKeyboard for definida como true, o tempo de execução ativa um teclado virtual quando uma instância InteractiveObject estiver pronta para aceitar a entrada do usuário. Uma instância InteractiveObject está pronta para aceitar a entrada do usuário após uma chamada programática preparar a propriedadefoco ou uma interação do usuário, como um "toque". Se o sistema do cliente tiver um teclado de hardware disponível ou não ser compatível com teclados virtuais, o teclado de função não é ativado.
As instâncias InteractiveObject despacha os eventos softKeyboardActivating, softKeyboardActivate, e softKeyboardDeactivate quando o teclado de função é ativado e desativado.
Observe: Esta propriedade não é compatível em aplicativos de AIR em iOS.
Implementação
public function get needsSoftKeyboard():Boolean public function set needsSoftKeyboard(value:Boolean):voidElementos da API relacionados
softKeyboard | propriedade |
softKeyboard:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 21.0 |
Controla a aparência do teclado suave.
Os dispositivos com teclados suaves podem personalizar os botões do teclado para corresponder com o tipo da entrada esperada. Por exemplo, se a entrada numérica for esperada, um dispositivo poderá utilizar SoftKeyboardType.NUMBER para exibir somente números no teclado suave. Os valores válidos são definidos como constantes na classe SoftKeyboardType:
- "default"
- "punctuation"
- "url"
- "number"
- "contact"
- "email"
- "phone"
- "decimalpad"
Estes valores servem como dicas, para ajudar um dispositivo exibir o melhor teclado para a operação atual.
O valor padrão é SoftKeyboardType.DEFAULT.
Implementação
public function get softKeyboard():String public function set softKeyboard(value:String):voidLança
ArgumentError — Se definido como qualquer valor que não seja integrante de SoftKeyboardType
|
Elementos da API relacionados
softKeyboardInputAreaOfInterest | propriedade |
softKeyboardInputAreaOfInterest:Rectangle| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.2, AIR 2.6 |
Define a área que deve permanecer na tela quando um teclado virtual for exibido (não disponível no iOS)
Se a propriedade needsSoftKeyboard deste InteractiveObject for true, o tempo de execução ajusta a exibição conforme necessário para manter o objeto na visualização enquanto o usuário digita. Geralmente o tempo de execução usa os limites de objeto obtidos do método DisplayObject.getBounds(). Você pode especificar uma área diferente usando esta propriedade softKeyboardInputAreaOfInterest.
Especifique a softKeyboardInputAreaOfInterest nas coordenadas de palco.
Observe: No Android, a softKeyboardInputAreaOfInterest não é respeitada em orientações de paisagem.
Observação: softKeyboardInputAreaOfInterest não é suportado no iOS.
Implementação
public function get softKeyboardInputAreaOfInterest():Rectangle public function set softKeyboardInputAreaOfInterest(value:Rectangle):voidElementos da API relacionados
tabEnabled | propriedade |
tabEnabled:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9 |
Especifica se este objeto está na ordem de tabulação. Se o objeto estiver na ordem de tabulação, o valor será true; caso contrário, o valor será false. Por padrão, o valor é false, exceto pelo seguinte:
- Para um objeto SimpleButton, o valor é
true. - Para um objeto TextField com
type = "input", o valor étrue. - Para um objeto Sprite ou MovieClip com
buttonMode = true, o valor étrue.
Implementação
public function get tabEnabled():Boolean public function set tabEnabled(value:Boolean):voidtabIndex | propriedade |
tabIndex:int| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9 |
Especifica a ordem de tabulação de objetos em um arquivo SWF. A propriedade tabIndex é -1 por padrão, significando que nenhum índice de tabulação é definido para o objeto.
Se qualquer objeto atualmente exibido no arquivo SWF contiver uma propriedade tabIndex, a ordenação de tabulação automática será desativada e essa ordenação será calculada a partir das propriedades tabIndex de objetos no arquivo SWF. A ordenação de tabulação personalizada inclui apenas objetos que possuem propriedades tabIndex.
A propriedade tabIndex pode ser um inteiro não negativo. Os objetos são ordenados de acordo com suas propriedades tabIndex, em ordem crescente. Um objeto com um valor tabIndex de 1 precede um objeto com um valor tabIndex de 2. Não use o mesmo valor tabIndex para vários objetos.
A ordenação de guia personalizada definida pela propriedade tabIndex é flat. Isso significa que nenhuma atenção é dada aos relacionamentos hierárquicos de objetos no arquivo SWF. Todos os objetos no arquivo SWF com propriedades tabIndex são inseridos na ordem de tabulação, que é determinada pela ordem dos valores tabIndex.
Nota: para definir a ordem de tabulação das instâncias TLFTextField, envie o filho do objeto de exibição de TLFTextField como um InteractiveObject e, em seguida, defina a propriedade tabIndex. Por exemplo:
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;Para reverter a ordem das guia a partir da configuração padrão para as três instâncias de um objeto TLFTextField (
tlfInstance1, tlfInstance2 e tlfInstance3), use:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementação
public function get tabIndex():int public function set tabIndex(value:int):voidInteractiveObject | () | Construtor |
public function InteractiveObject()| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Chamar o construtor new InteractiveObject() lança uma exceção ArgumentError. Entretanto, você pode chamar construtores para as seguintes subclasses de InteractiveObject:
new SimpleButton()new TextField()new Loader()new Sprite()new MovieClip()
requestSoftKeyboard | () | método |
public function requestSoftKeyboard():Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.2, AIR 2.6 |
Ativa um teclado virtual.
A chamada para este método enfoca o exemplo InteractiveObject e ativa o teclado virtual, se necessário. O needsSoftKeyboard também deve ser true. Um teclado não é levantado se um teclado de hardware estiver disponível, ou se o sistema do cliente não for compatível com teclados virtuais.
Observe: Este método não é compatível com aplicativos de AIR em iOS.
RetornaBoolean — Um valor de true os meios que o pedido de teclado suave foi concedido; false os meios que o teclado suave não foi levantado.
|
Elementos da API relacionados
clear | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.CLEAR| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Despachado quando o usuário seleciona "Clear" (ou "Delete") no menu de contexto do texto. Esse evento é despachado para o objeto com foco no momento. Se o objeto que no momento tem foco for um TextField, o comportamento padrão deste evento é fazer com que qualquer texto atualmente selecionado no campo de texto seja excluído.
A constanteEvent.CLEAR define o valor da propriedade type de um objeto de evento clear.
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 | Qualquer ocorrência do InteractiveObject com um ouvinte registrado para o evento clear. |
Observação: Os objetos de TextField não despacham eventos apagar, copiar, recortar, colar ou selectAll. Os objetos de TextField sempre incluem comando Cortar, Copiar, Colar, Limpar e Selecionar tudo, no menu de contexto. Você não pode remover estes comandos do menu de contexto de objetos TextField. Para objetos TextField, selecionar estes comandos (ou os seus equivalentes de teclado) não gera eventos clear, copy, cut, paste, ou selectAll. No entanto, outras classes que estendem a classe InteractiveObject, incluindo os componentes criados com o Flash Text Engine (FTE), despacham estes eventos em resposta a ações do usuários como atalhos de teclado e menus de contexto.
click | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.CLICK| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando um usuário pressiona e solta o botão principal do dispositivo apontador sobre o mesmo InteractiveObject. Para um evento "click" ocorrer, ele sempre deve seguir esta série de eventos, na ordem de ocorrência: evento mouseDown e, em seguida, mouseUp. O objeto de destino deve ser idêntico para ambos os eventos; caso contrário, o evento click não ocorrerá. Qualquer número de outros eventos de mouse pode ocorrer a qualquer momento entre os eventos mouseDown ou mouseUp; o cliente click ainda ocorrerá.
type de um objeto de evento click.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | Para eventos de clique, este valor é sempre false. |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
contextMenu | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.CONTEXT_MENU| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Despachado quando uma ação do usuário seleciona o menu de contexto associado a esse objeto interativo em um aplicativo do AIR.
A constanteMouseEvent.CONTEXT_MENU define o valor da propriedade type de um objeto de evento contextMenu.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | true se o botão direito do mouse estiver pressionado; false se não estiver. |
cancelable | false; o comportamento padrão não pode ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
clickCount | Contagem do número de cliques de mouse para indicar se o evento é parte de uma sequência de vários cliques. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
copy | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.COPY| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
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. Esse evento é despachado para o objeto com foco no momento. Se o objeto que no momento tem foco for um TextField, o comportamento padrão deste evento é fazer com que qualquer texto atualmente selecionado no campo de texto seja copiado para a área de transferência.
Define o valor da propriedadetype de um objeto de evento copy.
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 | Qualquer ocorrência do DisplayObject com um ouvinte registrado para o evento copy. |
Observação: Os objetos de TextField não despacham eventos apagar, copiar, recortar, colar ou selectAll. Os objetos de TextField sempre incluem comando Cortar, Copiar, Colar, Limpar e Selecionar tudo, no menu de contexto. Você não pode remover estes comandos do menu de contexto de objetos TextField. Para objetos TextField, selecionar estes comandos (ou os seus equivalentes de teclado) não gera eventos clear, copy, cut, paste, ou selectAll. No entanto, outras classes que estendem a classe InteractiveObject, incluindo os componentes criados com o Flash Text Engine (FTE), despacham estes eventos em resposta a ações do usuários como atalhos de teclado e menus de contexto.
cut | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.CUT| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
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. Esse evento é despachado para o objeto com foco no momento. Se o objeto que no momento tem foco for um TextField, o comportamento padrão deste evento é fazer com que qualquer texto atualmente selecionado no campo de texto seja recortado para a área de transferência.
Define o valor da propriedadetype de um objeto de evento cut.
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 | Qualquer ocorrência do DisplayObject com um ouvinte registrado para o evento cut. |
Observação: Os objetos de TextField não despacham eventos apagar, copiar, recortar, colar ou selectAll. Os objetos de TextField sempre incluem comando Cortar, Copiar, Colar, Limpar e Selecionar tudo, no menu de contexto. Você não pode remover estes comandos do menu de contexto de objetos TextField. Para objetos TextField, selecionar estes comandos (ou os seus equivalentes de teclado) não gera eventos clear, copy, cut, paste, ou selectAll. No entanto, outras classes que estendem a classe InteractiveObject, incluindo os componentes criados com o Flash Text Engine (FTE), despacham estes eventos em resposta a ações do usuários como atalhos de teclado e menus de contexto.
doubleClick | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.DOUBLE_CLICK| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9 |
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. Para que ocorra um evento doubleClick, ele deve seguir imediatamente esta série de eventos: mouseDown, mouseUp, clique em , mouseDowne mouseUp. Todos esses eventos devem compartilhar o mesmo destino que o evento doubleClick. O segundo clique, representado pelos segundos eventos mouseDown e mouseUp, devem ocorrer em um período de tempo específico após o evento click. O comprimento permitido desse período varia de acordo com o sistema operacional e, em muitos casos, pode ser configurado pelo usuário. Se o destino for um campo de texto selecionável, a palavra sob o ponteiro será selecionada como comportamento padrão. Se o destino InteractiveObject não tiver o seu sinalizador doubleClickEnabled definido como true, ele receberá dois eventos click.
A propriedade doubleClickEnabled assume false como padrão.
O comportamento de seleção de texto com clique duplo de um objeto TextField não está relacionado com o evento doubleClick. Use TextField.doubleClickEnabled para controlar seleções de TextField.
type de um objeto de evento doubleClick. A propriedade doubleClickEnabled deve ser true para um objeto gerar o evento doubleClick.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | Para eventos de duplo clique, este valor é sempre false. |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
focusIn | Evento |
flash.events.FocusEventpropriedade FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado depois que um objeto de exibição ganha foco. Essa situação acontece quando um usuário realça o objeto com um dispositivo apontador ou usando a navegação pelo teclado. O recebedor do foco é chamado de objeto de destino desse evento, enquanto a ocorrência de InteractiveObject correspondente que perdeu o foco devido a essa alteração é chamada de objeto relacionado. Uma referência ao objeto relacionado é armazenada na propriedade relatedObject do objeto recebedor. A propriedade shiftKey não é usada. Esse evento segue o despacho do evento focusOut do objeto anterior.
type de um objeto de evento focusIn.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
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. |
keyCode | 0; aplica-se apenas a eventos keyFocusChange. |
relatedObject | A ocorrência de InteractiveObject complementar que é afetada pela alteração no foco. |
shiftKey | false; aplica-se apenas a eventos keyFocusChange. |
target | A ocorrência InteractiveObject que acabou de receber foco. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento.
|
direção | A direção a partir da qual o foco foi atribuído. Essa propriedade relata o valor do parâmetro direction do método assignFocus() do estágio. Se o foco foi alterado por outros meios, o valor será sempre FocusDirection.NONE. Aplica-se apenas a eventos focusIn. Para todos os outros eventos de foco, o valor será FocusDirection.NONE. |
focusOut | Evento |
flash.events.FocusEventpropriedade FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado depois que um objeto de exibição perde o foco. Isso acontece quando um usuário realça um objeto diferente com um dispositivo apontador ou usando a navegação pelo teclado. O objeto que perde o foco é chamado de objeto de destino desse evento, enquanto a ocorrência de InteractiveObject correspondente que recebe o foco é chamada de objeto relacionado. Uma referência ao objeto relacionado é armazenada na propriedade relatedObject do objeto de destino. A propriedade shiftKey não é usada. Esse evento precede o despacho do evento focusIn pelo objeto relacionado.
type de um objeto de evento focusOut.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
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. |
keyCode | 0; aplica-se apenas a eventos keyFocusChange. |
relatedObject | A ocorrência de InteractiveObject complementar que é afetada pela alteração no foco. |
shiftKey | false; aplica-se apenas a eventos keyFocusChange. |
target | A ocorrência InteractiveObject que acabou de perder foco. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento.
|
gestureDirectionalTap | Evento |
flash.events.TransformGestureEventpropriedade TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_DIRECTIONAL_TAP| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 24, Flash Lite 4 |
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.
Especificamente, se um usuário mover o dedo sobre um InteractiveObject e depois mover os dedos juntos, a instância InteractiveObject pode enviar um evento touchBegin e um evento touchEnd (entre outros), além do eventogestureDirectionalTap, ou todos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você optar por controlar o evento touchBegin, então o mesmo controlador de eventos será executado em um dispositivo ativado por toque. Contudo, se você optar por controlar o evento gestureDirectionalTap, poderá projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado por toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar os dois eventos separadamente, de modo a fornecer uma resposta que não um evento de toque para um evento de gesto. No entanto, a classe flash.ui.Multitouch decidirá se o evento de toque ou gesto será acionado.
Ao controlar as propriedades do objeto de evento, observe que localX e localY estão definidas para o ponto primário do contato (na Apple TV, é o centro da tela). As propriedades offsetX e offsetY correspondem à direção do gesto.
Observação: esta API só é compatível com toques de um dedo.
Define o valor da propriedade detipo de um objeto de evento de toque GESTURE_DIRECTIONAL_TAP.
O objeto TransformGestureEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
fase | A fase atual no fluxo de eventos. Para batem eventos, este valor é sempre todos correspondente ao valor GesturePhase. TODOS uma vez que o evento é despachado. |
localX | A coordenada horizontal na qual o evento ocorreu, se comparado com a entidade gráfica. Para gestos de toque direcional, o valor é o centro da tela. |
localY | A coordenada vertical na qual o evento ocorreu, se comparado com a entidade gráfica. Para gestos de toque direcional, o valor é o centro da tela. |
scaleX | A escala horizontal do objeto de exibição. Para gestos de toque direcional, o valor é 1 |
scaleY | A escala vertical do objeto de exibição. Para gestos de toque direcional, o valor é 1 |
rotation | O ângulo de giro atual, em graus, do objeto de exibição ao longo do eixo z. Para gestos de toque direcional, o valor é 0 |
offsetX | Indica a direção horizontal: 1 para direita e -1 para esquerda. |
offsetY | Indica a direção vertical: 1 para baixo e -1 para cima. |
velocity | Indica, em pixels por segundo, a velocidade do gesto de deslizar (apenas para AIR). |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
gestureLongPress | Evento |
flash.events.TapGestureEventpropriedade TapGestureEvent.type =
flash.events.GestureEvent.GESTURE_LONG_PRESS| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Alguns dispositivos também podem interpretar este contato como um evento doubleClick.
Especificamente, se um usuário toca dois dedos em InteractiveObject, a instância InteractiveObject pode despachar um evento doubleClick ou um evento gestureTwoFingerTap, ou ambos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o eventodoubleClick, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e um dispositivo ativado pelo mouse. Contudo, se você escolher controlar o evento gestureTwoFingerTap, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Elementos da API relacionados
gesturePan | Evento |
flash.events.TransformGestureEventpropriedade TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_PAN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Alguns dispositivos também poderiam interpretar este contato como um evento mouseOver e como um evento touchOver.
Especificamente, se um usuário move um dedo em InteractiveObject, a instância InteractiveObject pode despachar um evento mouseOver ou um evento touchOver ou um evento gesturePan, ou todos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o evento mouseOver, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e em um dispositivo ativado pelo mouse. Contudo, se você escolhe controlar o evento gesturePan, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor da propriedadetype de um objeto de evento de toqueGESTURE_PAN.
O objeto TransformGestureEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
fase | A fase atual no fluxo de evento; um valor da classe GesturePhase. |
localX | A coordenada horizontal na qual o evento ocorreu com relação ao objeto de exibição continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação ao objeto de exibição continente. |
scaleX | A escala horizontal do objeto de exibição desde o evento de gesto anterior. Para gestos de panela este valor é 1. |
scaleY | A escala vertical do objeto de exibição desde o evento de gesto anterior. Para gestos de panela este valor é 1. |
rotation | O ângulo de giro atual, em graus, do objeto de exibição ao longo do eixo z, desde o evento de gesto anterior. Para gestos de panela este valor é 0. |
offsetX | A conversão horizontal do objeto de exibição da sua posição no evento de gesto anterior. |
offsetY | A conversão vertical do objeto de exibição da sua posição no evento de gesto anterior. |
velocity | Indica, em pixels por segundo, a velocidade do evento de gesto (apenas para AIR). Para movimentos de panorâmica, este valor é 0 |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Exemplo ( Como usar este exemplo )
GESTURE_PAN. Enquanto o usuário executa um gesto em forma de panela no dispositivo sensível ao toque, myTextField preenche dados com a fase atual.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onPan(evt:TransformGestureEvent):void {
evt.target.localX++;
if (evt.phase==GesturePhase.BEGIN) {
myTextField.text = "Begin";
}
if (evt.phase==GesturePhase.UPDATE) {
myTextField.text = "Update";
}
if (evt.phase==GesturePhase.END) {
myTextField.text = "End";
}
}
Elementos da API relacionados
gestureRotate | Evento |
flash.events.TransformGestureEventpropriedade TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_ROTATE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). A rotação de dois dedos é um gesto de rotação comum, mas cada dispositivo e sistema operacional podem ter seus próprios requisitos para indicar rotação. Alguns dispositivos também podem interpretar este contato como uma combinação de vários eventos de mouse, também.
Especificamente, se um usuário move um dedo sobre um InteractiveObject, a instância InteractiveObject pode despachar um evento mouseOver e um evento click (entre outros), além do evento gestureRotate, ou todos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o evento mouseOver, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e em um dispositivo ativado pelo mouse. Contudo, se você escolher controlar o evento gestureRotate, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Ao controlar as propriedades do objeto do evento, observe que as propriedades localX e localY são definidas para o ponto principal do contato. As propriedades offsetX e offsetY são a distância do ponto do contato em que o gesto de rotação é concluído.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor da propriedadetype de um objeto de evento de toque GESTURE_ROTATE.
Durante esse evento, a propriedade rotation contém o ângulo de rotação. Os valores de rotação são os seguintes:
- 0 a 180 graus no sentido horário
- - 180 a 0 graus no sentido anti-horário
O objeto TransformGestureEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
fase | A fase atual no fluxo de evento; um valor da classe GesturePhase. |
localX | A coordenada horizontal na qual o evento ocorreu com relação ao objeto de exibição continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação ao objeto de exibição continente. |
scaleX | A escala horizontal do objeto de exibição desde o evento de gesto anterior. |
scaleY | A escala vertical do objeto de exibição desde o evento de gesto anterior. |
rotation | O ângulo de giro atual, em graus, do objeto de exibição ao longo do eixo z, desde o evento de gesto anterior. |
offsetX | A conversão horizontal do objeto de exibição da sua posição no evento de gesto anterior. |
offsetY | A conversão vertical do objeto de exibição da sua posição no evento de gesto anterior. |
velocity | Indica, em pixels por segundo, a velocidade do evento de gesto (apenas para AIR). Para movimentos de rotação, este valor é 0 |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Exemplo ( Como usar este exemplo )
GESTURE_ROTATE. Enquanto o usuário realiza um gesto de rotação no dispositivo ativado pelo toque, o mySprite gira e myTextField preenche com a fase atual.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onRotate(evt:TransformGestureEvent):void {
evt.target.rotation -= 45;
if (evt.phase==GesturePhase.BEGIN) {
myTextField.text = "Begin";
}
if (evt.phase==GesturePhase.UPDATE) {
myTextField.text = "Update";
}
if (evt.phase==GesturePhase.END) {
myTextField.text = "End";
}
}
Elementos da API relacionados
gestureSwipe | Evento |
flash.events.TransformGestureEventpropriedade TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_SWIPE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Mover vários dedos em paralelo é um gesto de deslize comum, mas cada dispositivo e sistema operacional pode ter as suas próprias exigências de deslize. Alguns dispositivos também podem interpretar este contato como uma combinação de vários eventos de mouse, também.
Especificamente, se um usuário move o dedo sobre um InteractiveObject e depois move os dedos juntos, a instância InteractiveObject pode despachar um evento rollOver e um evento rollOut (entre outros), além do eventogestureSwipe, ou todos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Se você escolher controlar o evento rollOver, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e um dispositivo ativado pelo mouse. Contudo, se você escolher controlar o evento gestureSwipe, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Ao controlar as propriedades do objeto do evento, observe que as propriedades localX e localY são definidas para o ponto principal do contato. As propriedades offsetX e offsetY são a distância do ponto do contato em que o gesto de toque é concluído.
Observação: Enquanto alguns dispositivos que usam o sistema operacional Mac podem interpretar um gesto de quatro dedos, este API só suporta um de três dedos.
Define o valor da propriedadetype de um objeto de evento de toque GESTURE_SWIPE.
O objeto TransformGestureEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
fase | A fase atual no fluxo de eventos. Para batem eventos, este valor é sempre todos correspondente ao valor GesturePhase. TODOS uma vez que o evento é despachado. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
scaleX | A escala horizontal do objeto de exibição. Para gestos de batida este valor é 1 |
scaleY | A escala vertical do objeto de exibição. Para gestos de batida este valor é 1 |
rotation | O ângulo de giro atual, em graus, do objeto de exibição ao longo do eixo z. Para gestos de batida este valor é 0 |
offsetX | Indica a direção horizontal: 1 para direita e -1 para esquerda. |
offsetY | Indica a direção vertical: 1 para baixo e -1 para cima. |
velocity | Indica, em pixels por segundo, a velocidade do gesto de deslizar (apenas para AIR). Para o resto, esse valor é 0 |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Exemplo ( Como usar este exemplo )
GESTURE_SWIPE. Enquanto o usuário executa um gesto em forma de pancada no dispositivo sensível ao toque, myTextField preenche dados com a fase all, que é a única fase para eventos de pancada.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onSwipe(evt:TransformGestureEvent):void {
if (evt.offsetX == 1 ) {
myTextField.text = "right";
}
if (evt.offsetY == -1) {
myTextField.text = "up";
}
myTextField.text = evt.phase;
}
Elementos da API relacionados
gestureTap | Evento |
flash.events.TapGestureEventpropriedade TapGestureEvent.type =
flash.events.PressAndTapGestureEvent.GESTURE_TAP| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Alguns dispositivos também podem interpretar este contato como uma combinação de vários eventos de mouse, também.
Especificamente, se um usuário mover um dedo sobre um InteractiveObject e depois der um segundo toque, a instância InteractiveObject pode despachar um evento mouseOver e um evento click (entre outros), bem como o evento gesturePressAndTap, ou todos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o evento mouseOver, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e em um dispositivo ativado pelo mouse. Contudo, se você escolhe controlar o evento gesturePressAndTap, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Ao controlar as propriedades do objeto de evento, observe que as propriedades localX e localY são definidas para o ponto primário do contato ("apertar"). As propriedades offsetX e offsetY são a distância ao ponto secundário do contato ("tocar").
Elementos da API relacionados
gestureZoom | Evento |
flash.events.TransformGestureEventpropriedade TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_ZOOM| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Mover os dedos é um zoom comum, mas cada dispositivo e o sistema operacional podem ter as suas próprias exigências para indicar zoom. Alguns dispositivos também podem interpretar este contato como uma combinação de vários eventos de mouse, também.
Especificamente, se um usuário move o dedo sobre um InteractiveObject e depois move os dedos separando-os, a instância InteractiveObject pode despachar um evento mouseOver e um evento click (entre outros), além do eventogestureZoom, ou todos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o evento mouseOver, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e em um dispositivo ativado pelo mouse. Contudo, se você escolher controlar o evento gestureZoom, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Ao controlar as propriedades do objeto do evento, observe que as propriedades localX e localY são definidas para o ponto principal do contato. As propriedadesoffsetX e offsetY são a distância ao ponto do contato em que o de zoom é concluído.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor da propriedadetype de um objeto de evento de toque GESTURE_ZOOM.
O objeto TransformGestureEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
fase | A fase atual no fluxo de evento; um valor da classe GesturePhase. |
localX | A coordenada horizontal na qual o evento ocorreu com relação ao objeto de exibição continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação ao objeto de exibição continente. |
scaleX | A escala horizontal do objeto de exibição desde o evento de gesto anterior. |
scaleY | A escala vertical do objeto de exibição desde o evento de gesto anterior. |
rotation | O ângulo de giro atual, em graus, do objeto de exibição ao longo do eixo z, desde o evento de gesto anterior. |
offsetX | A conversão horizontal do objeto de exibição da sua posição no evento de gesto anterior. |
offsetY | A conversão vertical do objeto de exibição da sua posição no evento de gesto anterior. |
velocity | Indica, em pixels por segundo, a velocidade do evento de gesto (apenas para AIR). Para o gesto de zoom, este valor é 0 |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Exemplo ( Como usar este exemplo )
GESTURE_ZOOM. Enquanto o usuário executa um gesto em zoom no dispositivo sensível ao toque, myTextField preenche dados com a fase atual.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onZoom(evt:TransformGestureEvent):void {
evt.target.scaleX++;
if (evt.phase==GesturePhase.BEGIN) {
myTextField.text = "Begin";
}
if (evt.phase==GesturePhase.UPDATE) {
myTextField.text = "Update";
}
if (evt.phase==GesturePhase.END) {
myTextField.text = "End";
}
}
Elementos da API relacionados
imeStartComposition | Evento |
flash.events.IMEEvent| Versões de runtime: | Flash Lite 4 |
Este evento é despachado para qualquer aplicativo cliente que suporte a entrada incorporada com um IME
keyDown | Evento |
flash.events.KeyboardEventpropriedade KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando o usuário pressiona uma tecla. Os mapeamentos entre teclas e caracteres específicos variam por dispositivo e sistema operacional. Esse tipo de evento é gerado depois que esse tipo de mapeamento ocorre, mas antes do processamento de um IME (editor de métodos de entrada). IMEs são usados para digitar caracteres, como ideogramas chineses, que o teclado QWERTY padrão não está bem equipado para fornecer. Esse evento ocorre antes do evento keyUp.
No AIR, cancelar este evento impede o caractere de ser introduzido em um campo de texto.
A constanteKeyboardEvent.KEY_DOWN define o valor da propriedade type de um objeto de evento keyDown.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
cancelable | true em AIR, false em Flash Player; no AIR, o cancelamento deste evento impede o caractere de ser introduzido em um campo de texto. |
charCode | O valor de código de caractere da tecla pressionada ou solta. |
commandKey | true no Mac caso a tecla Command esteja ativa. Caso contrário, false |
controlKey | true no Windows e no Linux caso a tecla Ctrl esteja ativa. true no Mac caso a tecla Control esteja ativa. Caso contrário, false |
ctrlKey | true no Windows e no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
keyCode | O valor de código da tecla pressionada ou solta. |
keyLocation | O local da tecla no teclado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
target | A ocorrência InteractiveObject com foco. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
keyFocusChange | Evento |
flash.events.FocusEventpropriedade FocusEvent.type =
flash.events.FocusEvent.KEY_FOCUS_CHANGE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando o usuário tenta alterar o foco usando a navegação pelo teclado. O comportamento padrão desse evento é alterar o foco e despachar os eventos focusIn e focusOut correspondentes.
Esse evento é despachado para o objeto com foco no momento. O objeto relacionado para esse evento é a ocorrência de InteractiveObject que receberá o foco se você não impedir o comportamento padrão. Você pode impedir a alteração no foco chamando o método preventDefault() em um ouvinte de evento corretamente registrado junto ao objeto de destino. O foco é alterado e os eventos focusIn e focusOut são, por padrão, despachados.
type de um objeto de evento keyFocusChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
cancelable | true; chama o método preventDefault() para cancelar o comportamento padrão. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
keyCode | O valor de código da tecla pressionada para disparar um evento keyFocusChange. |
relatedObject | A ocorrência de InteractiveObject complementar que é afetada pela alteração no foco. |
shiftKey | true se o modificador da tecla Shift estiver ativado; false se não estiver ativado. |
target | A ocorrência InteractiveObject que atualmente tem o foco. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento.
|
keyUp | Evento |
flash.events.KeyboardEventpropriedade KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando o usuário solta uma tecla. Os mapeamentos entre teclas e caracteres específicos variam por dispositivo e sistema operacional. Esse tipo de evento é gerado depois que esse tipo de mapeamento ocorre, mas antes do processamento de um IME (editor de métodos de entrada). IMEs são usados para digitar caracteres, como ideogramas chineses, que o teclado QWERTY padrão não está bem equipado para fornecer. Esse evento ocorre depois de um evento keyDown e tem as seguintes características:
KeyboardEvent.KEY_UP define o valor da propriedade type de um objeto de evento keyUp.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
charCode | Contém o valor de código de caractere da tecla pressionada ou solta. |
commandKey | true no Mac caso a tecla Command esteja ativa. Caso contrário, false |
controlKey | true no Windows e no Linux caso a tecla Ctrl esteja ativa. true no Mac caso a tecla Control esteja ativa. Caso contrário, false |
ctrlKey | true no Windows se a tecla Ctrl estiver ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
keyCode | O valor de código da tecla pressionada ou solta. |
keyLocation | O local da tecla no teclado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
target | A ocorrência InteractiveObject com foco. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
middleClick | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.MIDDLE_CLICK| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado quando um usuário pressiona e libera o botão do meio do dispositivo apontador sobre o mesmo InteractiveObject. Para que um evento middleClick ocorra, ele deve sempre seguir esta série de eventos, por ordem de ocorrência: evento middleMouseDown e, em seguida, middleMouseUp. O objeto de destino deve ser idêntico para ambos os eventos; caso contrário, o evento middleClick não ocorrerá. Qualquer número de outros eventos de mouse pode ocorrer a qualquer momento entre os eventos middleMouseDown ou middleMouseUp; o evento middleClick ainda ocorrerá.
type de um objeto de evento middleClick.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | Para eventos de clique com o botão do meio, esta propriedade é sempre false. |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
middleMouseDown | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.MIDDLE_MOUSE_DOWN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado quando o usuário pressiona o botão do meio do dispositivo apontador sobre uma ocorrência InteractiveObject.
Define o valor da propriedadetype de um objeto de evento middleMouseDown.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | true se o botão do meio do mouse estiver pressionado; false se não estiver. |
cancelable | false; o comportamento padrão não pode ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
clickCount | Contagem do número de cliques de mouse para indicar se o evento é parte de uma sequência de vários cliques. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
middleMouseUp | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.MIDDLE_MOUSE_UP| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.
Define o valor da propriedadetype de um objeto de evento middleMouseUp.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | true se o botão do meio do mouse estiver pressionado; false se não estiver. |
cancelable | false; o comportamento padrão não pode ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
clickCount | Contagem do número de cliques de mouse para indicar se o evento é parte de uma sequência de vários cliques. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
mouseDown | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.MOUSE_DOWN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. Se o destino for uma ocorrência de SimpleButton, essa ocorrência mostrará o objeto downState como comportamento padrão. Se o destino for um campo de texto selecionável, esse campo de texto iniciará a seleção como comportamento padrão.
type de um objeto de evento mouseDown.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
cancelable | false; o comportamento padrão não pode ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows e no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
clickCount | Contagem do número de cliques de mouse para indicar se o evento é parte de uma sequência de vários cliques. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
mouseFocusChange | Evento |
flash.events.FocusEventpropriedade FocusEvent.type =
flash.events.FocusEvent.MOUSE_FOCUS_CHANGE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando o usuário tenta alterar o foco usando um dispositivo apontador. O comportamento padrão desse evento é alterar o foco e despachar os eventos focusIn e focusOut correspondentes.
Esse evento é despachado para o objeto com foco no momento. O objeto relacionado para esse evento é a ocorrência de InteractiveObject que receberá o foco se você não impedir o comportamento padrão. Você pode impedir a alteração no foco chamando preventDefault() em um ouvinte de evento corretamente registrado junto ao objeto de destino. A propriedade shiftKey não é usada. O foco é alterado e os eventos focusIn e focusOut são, por padrão, despachados.
type de um objeto de evento mouseFocusChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
cancelable | true; chama o método preventDefault() para cancelar o comportamento padrão. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
keyCode | 0; aplica-se apenas a eventos keyFocusChange. |
relatedObject | A ocorrência de InteractiveObject complementar que é afetada pela alteração no foco. |
shiftKey | false; aplica-se apenas a eventos keyFocusChange. |
target | A ocorrência InteractiveObject que atualmente tem o foco. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento.
|
mouseMove | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.MOUSE_MOVE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando um usuário move o dispositivo apontador enquanto ele está sobre InteractiveObject. Se o destino for um campo de texto que o usuário está selecionado, a seleção será atualizada como comportamento padrão.
Define o valor da propriedadetype de um objeto de evento de evento mouseMove.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
cancelable | false; o comportamento padrão não pode ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
mouseOut | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.MOUSE_OUT| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject. O destino do evento é o objeto que estava anteriormente sob o dispositivo apontador. O objetoRelacionado é o objeto para o qual o dispositivo apontador foi movido. Se o destino for uma ocorrência de SimpleButton, o botão mostrará o objeto de exibição upState como comportamento padrão.
O evento mouseOut é despachado sempre que o mouse sai da área de qualquer objeto-filho do contêiner de objetos de exibição, mesmo que o mouse permaneça sobre outro objeto-filho desse contêiner. Trata-se de um comportamento diferente da finalidade do evento rollOut, que é simplificar a codificação de comportamentos de rolagem para contêineres de objetos de exibição com filhos. Quando o mouse sai da área de um objeto de exibição ou da área de qualquer um dos seus filhos para ir até um objeto que não é um dos seus filhos, o objeto de exibição despacha o evento rollOut. Eventos rollOut são despachados consecutivamente acima na cadeia de pais do objeto, começando por esse objeto e terminando com o pai mais alto que não é a raiz nem um predecessor do objetoRelacionado.
type de um objeto de evento mouseOut.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
cancelable | false; o comportamento padrão não pode ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
relatedObject | O objeto da lista de exibição para o qual o dispositivo apontador aponta agora. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
mouseOver | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.MOUSE_OVER| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject. O objetoRelacionado é o objeto que estava anteriormente sob o dispositivo apontador. Se o destino for uma ocorrência de SimpleButton, o objeto mostrará o objeto de exibição overState ou upState, dependendo de o botão do mouse estar ou não pressionado, como o comportamento padrão.
O evento mouseOver é despachado sempre que o mouse entra na área de qualquer objeto-filho do contêiner de objetos de exibição, mesmo que o mouse já tenha estado sobre outro objeto-filho desse contêiner. Trata-se de um comportamento diferente da finalidade do evento rollOver, que é simplificar a codificação de comportamentos de rolagem para contêineres de objetos de exibição com filhos. Quando o mouse entrar na área de um objeto de exibição ou na área de qualquer um dos seus filhos a partir de um objeto que não é um de seus filhos, o objeto de exibição despachará o evento rollOver. Os eventos rollOver são despachados consecutivamente para baixo na cadeia de pais do objeto, começando pelo pai mais alto, que não é a raiz nem um predecessor do objetoRelacionado, e terminando com o objeto.
type de um objeto de evento mouseOver.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
cancelable | false; o comportamento padrão não pode ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
relatedObject | O objeto da lista de exibição para o qual o dispositivo apontador estava apontando. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
mouseUp | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.MOUSE_UP| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject. Se o destino for uma ocorrência de SimpleButton, o objeto mostrará o objeto de exibição upState. Se o destino for um campo de texto selecionável, esse campo de texto finalizará a seleção como comportamento padrão.
type de um objeto de evento select.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
cancelable | false; o comportamento padrão não pode ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
clickCount | Contagem do número de cliques de mouse para indicar se o evento é parte de uma sequência de vários cliques. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
mouseWheel | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.MOUSE_WHEEL| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9 |
Despachado quando a roda do mouse rola sobre uma ocorrência InteractiveObject. Se o destino for um campo de texto, o texto será rolado como o comportamento padrão. Só disponível em sistemas operacionais Windows Microsoft.
Define o valor da propriedadetype de um objeto de evento mouseWheel.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
cancelable | false; o comportamento padrão não pode ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
delta | O número de linhas que cada fenda da roda do mouse representa. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
nativeDragComplete | Evento |
flash.events.NativeDragEventpropriedade NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_COMPLETE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado pelo iniciador de arrasto InteractiveObject quando o usuário libera o gesto de arrastar.
A propriedade dropAction do evento indica a ação definida pelo objeto drag target; o valor "none" (DragActions.NONE) indica que a liberação foi cancelada ou não foi aceita.
O manipulador de eventos nativeDragComplete é um local conveniente para atualizar o estado do objeto de exibição que inicia, por exemplo, removendo um item de uma lista (em uma ação de arrasto "move") ou alterando as propriedades visuais.
type de um objeto de evento nativeDragComplete.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
clipboard | O objeto Clipboard que contém os dados arrastados. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
nativeDragDrop | Evento |
flash.events.NativeDragEventpropriedade NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_DROP| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado pelo InteractiveObject de destino quando um objeto arrastado é solto nele e a liberação tiver sido aceita com uma chamada para DragManager.acceptDragDrop().
Acessa os dados soltos usando a propriedade clipboard do objeto de evento.
O manipulador deste evento deve definir a propriedade DragManager.dropAction para fornecer feedback ao objeto iniciador sobre que ação de arrasto foi realizada. Se nenhum valor for definido, o DragManager selecionará um valor padrão na lista de ações permitidas.
type de um objeto de evento nativeDragDrop.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | true; o cancelamento deste evento cancela a operação de arrastar. |
clipboard | O objeto Clipboard que contém os dados arrastados. Clipboard só pode ser lido se o objeto que está enviando esse evento não estiver no mesmo domínio de segurança do iniciador. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
nativeDragEnter | Evento |
flash.events.NativeDragEventpropriedade NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_ENTER| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado por um InteractiveObject quando o gesto de arrasto entra no respectivo limite.
Manipule eventos nativeDragEnter ou nativeDragOver para permitir que o objeto de exibição se torne o destino de liberação.
Para determinar se o objeto de exibição de despacho pode aceitar a liberação, verifique a compatibilidade dos dados na propriedade clipboard do objeto de evento, além das ações de arrasto permitidas na propriedade allowedActions.
type de um objeto de evento nativeDragEnter.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
clipboard | O objeto Clipboard que contém os dados arrastados. A área de transferência só poderá ser lida se o objeto que está despachando este evento se encontrar no mesmo domínio de segurança que o iniciador. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
nativeDragExit | Evento |
flash.events.NativeDragEventpropriedade NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_EXIT| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado por um InteractiveObject quando o gesto de arrasto deixa o respectivo limite.
O NativeDragEvent.NATIVE_DRAG_EXIT define o valor da propriedadetype de um objeto de evento nativeDragExit.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
clipboard | O objeto Clipboard que contém os dados arrastados. A área de transferência só poderá ser lida se o objeto que está despachando este evento se encontrar no mesmo domínio de segurança que o iniciador. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
nativeDragOver | Evento |
flash.events.NativeDragEventpropriedade NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_OVER| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado continuamente por um InteractiveObject enquanto o gesto de arrasto permanecer dentro do respectivo limite.
Eventos nativeDragOver são despachados sempre que o mouse é movimentado. No Windows e no Mac, eles também são despachados em um intervalo de timer menor quando o mouse não é movimentado.
Manipule eventos nativeDragOver ou nativeDragEnter para permitir que o objeto de exibição se torne o destino de liberação.
Para determinar se o objeto de exibição de despacho pode aceitar a liberação, verifique a compatibilidade dos dados na propriedade clipboard do objeto de evento, além das ações de arrasto permitidas na propriedade allowedActions.
type de um objeto de evento nativeDragOver.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | true; o cancelamento deste evento cancela a operação de arrastar. |
clipboard | O objeto Clipboard que contém os dados arrastados. A área de transferência só poderá ser lida se o objeto que está despachando este evento se encontrar no mesmo domínio de segurança que o iniciador. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
nativeDragStart | Evento |
flash.events.NativeDragEventpropriedade NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_START| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado no início de uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag().
O NativeDragEvent.NATIVE_DRAG_START define o valor da propriedadetype de um objeto de evento nativeDragStart.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | true; o cancelamento deste evento cancela a operação de arrastar. |
clipboard | O objeto Clipboard que contém os dados arrastados. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
nativeDragUpdate | Evento |
flash.events.NativeDragEventpropriedade NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_UPDATE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado durante uma operação de arrasto pelo InteractiveObject, que é especificado como o iniciador de arrasto na chamada DragManager.doDrag().
Eventos nativeDragUpdate não são despachados no Linux.
type de um objeto de evento nativeDragUpdate.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
clipboard | O objeto Clipboard que contém os dados arrastados. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
paste | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.PASTE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
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. Esse evento é despachado para o objeto com foco no momento. Se o objeto que no momento tem o foco for um TextField, o comportamento padrão deste evento é fazer com que o conteúdo da área de transferência seja colado no campo de texto no ponto de inserção atual, substituindo qualquer texto atualmente selecionado no campo de texto.
A constanteEvent.PASTE define o valor da propriedade type de um objeto de evento paste.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true (false para runtime do AIR.) |
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 | Qualquer ocorrência do DisplayObject com um ouvinte registrado para o evento paste. |
Observação: Os objetos de TextField não despacham eventos apagar, copiar, recortar, colar ou selectAll. Os objetos de TextField sempre incluem comando Cortar, Copiar, Colar, Limpar e Selecionar tudo, no menu de contexto. Você não pode remover estes comandos do menu de contexto de objetos TextField. Para objetos TextField, selecionar estes comandos (ou os seus equivalentes de teclado) não gera eventos clear, copy, cut, paste, ou selectAll. No entanto, outras classes que estendem a classe InteractiveObject, incluindo os componentes criados com o Flash Text Engine (FTE), despacham estes eventos em resposta a ações do usuários como atalhos de teclado e menus de contexto.
proximityBegin | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_BEGIN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Despachado quando o usuário abaixa um estilo ativo para além do limite de detecção de proximidade da tela.
A sequência dos eventos típica que ocorre quando um usuário abaixa um estilo à tela, move-o através da tela e o levanta é:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor dotipo da propriedade de um objeto de evento de toque PROXIMITY_BEGIN.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
timestamp | (Somente AIR) A marca de data e hora do evento em milissegundos quanto ao início do aplicativo. |
touchIntent | (Somente AIR) Um valor da classe de TouchEventIntent. |
isTouchPointCanceled | (Somente AIR) true se o evento de toque for cancelado devido à lógica de rejeição do toque do dispositivo. |
Elementos da API relacionados
proximityEnd | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_END| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Despachado quando o usuário levanta um estilo ativo acima do limite de detecção de proximidade da tela.
Um evento proximityEnd não é despachado quando o estilo toca a tela.
A sequência dos eventos típica que ocorre quando um usuário abaixa um estilo à tela, move-o através da tela e o levanta é:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor dotipo da propriedade de um objeto de evento de toquePROXIMITY_END.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
timestamp | (Somente AIR) A marca de data e hora do evento em milissegundos quanto ao início do aplicativo. |
touchIntent | (Somente AIR) Um valor da classe de TouchEventIntent. |
isTouchPointCanceled | (Somente AIR) true se o evento de toque for cancelado devido à lógica de rejeição do toque do dispositivo. |
Elementos da API relacionados
proximityMove | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_MOVE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Despachado quando o usuário move um estilo ativo sobre a tela enquanto permanece dentro do limite de detecção de proximidade.
A sequência dos eventos típica que ocorre quando um usuário abaixa um estilo à tela, move-o através da tela e o levanta é:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor dotipo da propriedade de um objeto de evento de toque PROXIMITY_MOVE.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
timestamp | (Somente AIR) A marca de data e hora do evento em milissegundos quanto ao início do aplicativo. |
touchIntent | (Somente AIR) Um valor da classe de TouchEventIntent. |
isTouchPointCanceled | (Somente AIR) true se o evento de toque for cancelado devido à lógica de rejeição do toque do dispositivo. |
Elementos da API relacionados
proximityOut | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_OUT| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
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.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor dotipo da propriedade de um objeto de evento de toque PROXIMITY_OUT.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
timestamp | (Somente AIR) A marca de data e hora do evento em milissegundos quanto ao início do aplicativo. |
touchIntent | (Somente AIR) Um valor da classe de TouchEventIntent. |
isTouchPointCanceled | (Somente AIR) true se o evento de toque for cancelado devido à lógica de rejeição do toque do dispositivo. |
Elementos da API relacionados
proximityOver | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_OVER| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
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.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor dotipo da propriedade de um objeto de evento de toque PROXIMITY_OVER.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
timestamp | (Somente AIR) A marca de data e hora do evento em milissegundos quanto ao início do aplicativo. |
touchIntent | (Somente AIR) Um valor da classe de TouchEventIntent. |
isTouchPointCanceled | (Somente AIR) true se o evento de toque for cancelado devido à lógica de rejeição do toque do dispositivo. |
Elementos da API relacionados
proximityRollOut | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_ROLL_OUT| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
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.
O destino do evento é o objeto anteriormente sob o estilo ou um pai desse objeto. O relatedObject é o objeto que o estilo moveu para cima. Os eventos proximityRollOut são despachados consecutivamente para cima na cadeia de pais do objeto, começando pelo objeto e terminando com o pai mais alto, que não é a raiz nem um predecessor do relatedObject.
A finalidade do evento proximityRollOut é simplificar a codificação de comportamentos de rolagem para contêineres de objetos de exibição com filhos. Quando o estilo sair da área de um objeto de exibição, incluindo a área de qualquer um de seus filhos para ir até um objeto que não é um de seus filhos, o objeto de exibição despachará o evento proximityRollOut. Trata-se de um comportamento diferente daquele do evento proximityRollOut, que é despachado sempre que o mouse sai da área de qualquer objeto-filho do contêiner de objetos de exibição, mesmo que o mouse permaneça sobre outro objeto-filho desse contêiner.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor dotipo da propriedade de um objeto de evento de toque PROXIMITY_ROLL_OUT.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
timestamp | (Somente AIR) A marca de data e hora do evento em milissegundos quanto ao início do aplicativo. |
touchIntent | (Somente AIR) Um valor da classe de TouchEventIntent. |
isTouchPointCanceled | (Somente AIR) true se o evento de toque for cancelado devido à lógica de rejeição do toque do dispositivo. |
Elementos da API relacionados
proximityRollOver | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events. TouchEvent. PROXIMITY_ROLL_OVER| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
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).
O destino do evento é o objeto sob o estilo ou um pai desse objeto. O relatedObject é o objeto que anteriormente estava sob a caneta. Os eventos proximityRollOver são despachados consecutivamente para baixo na cadeia de pais do objeto, começando pelo pai mais alto, que não é a raiz nem um predecessor do objetoRelacionado e terminando com o objeto.
A finalidade do evento proximityRollOver é simplificar a codificação de comportamentos de rolagem para contêineres de objetos de exibição com filhos. Quando o estilo entrar na área de um objeto de exibição ou acima de qualquer um dos seus filhos a partir de um objeto que não seja um de seus filhos, o objeto de exibição despachará o evento proximityRollOver. Trata-se de um comportamento diferente daquele do evento proximityRollOver, que é despachado sempre que o mouse entra na área de qualquer objeto-filho do contêiner de objetos de exibição, mesmo que o mouse já tenha estado sobre outro objeto-filho desse contêiner.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Elementos da API relacionados
releaseOutside | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.RELEASE_OUTSIDE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3.3, Flash Player 11.3 |
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. Se o destino for uma ocorrência de SimpleButton, o objeto mostrará o objeto de exibição upState. Se o destino for um campo de texto selecionável, esse campo de texto finalizará a seleção como comportamento padrão.
type de um objeto de evento releaseOutside.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | false |
cancelable | false; o comportamento padrão não pode ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
clickCount | Contagem do número de cliques de mouse para indicar se o evento é parte de uma sequência de vários cliques. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | O InteractiveObject sobre o qual o botão de dispositivo de ponteiro foi pressionado anteriormente e fora da instância e liberado. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
rightClick | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.RIGHT_CLICK| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado quando um usuário pressiona e libera o botão direito do dispositivo apontador sobre o mesmo InteractiveObject. Para que um evento rightClick ocorra, ele sempre deve seguir esta série de eventos, pela ordem de ocorrência: evento rightMouseDown e, em seguida, rightMouseUp. O objeto de destino deve ser idêntico para ambos os eventos; caso contrário, o eventorightClick não ocorrerá. Qualquer número de outros eventos de mouse podem ocorrer a qualquer momento entre os eventos rightMouseDown ou rightMouseUp; o evento rightClick ainda ocorrerá.
type de um objeto de evento rightClick.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | Para eventos de clique com o botão direito do mouse, esta propriedade é sempre false. |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
rightMouseDown | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.RIGHT_MOUSE_DOWN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado quando o usuário pressiona o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.
Define o valor da propriedadetype de um objeto de evento rightMouseDown.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | Para eventos de clique com o botão direito do mouse, esta propriedade é sempre true. |
cancelable | false; o comportamento padrão não pode ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
clickCount | Contagem do número de cliques de mouse para indicar se o evento é parte de uma sequência de vários cliques. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
rightMouseUp | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.RIGHT_MOUSE_UP| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.
Define o valor da propriedadetype de um objeto de evento rightMouseUp.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | true |
buttonDown | true se o botão direito do mouse estiver pressionado; false se não estiver. |
cancelable | false; o comportamento padrão não pode ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
clickCount | Contagem do número de cliques de mouse para indicar se o evento é parte de uma sequência de vários cliques. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
rollOut | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.ROLL_OUT| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando o usuário move um dispositivo apontador para longe de uma ocorrência de InteractiveObject. O destino do evento é o objeto que estava anteriormente sob o dispositivo apontador ou um pai desse objeto. O objetoRelacionado é o objeto para o qual o dispositivo apontador foi movido. Os eventos rollOut são despachados consecutivamente para cima na cadeia de pais do objeto, começando pelo objeto e terminando com o pai mais alto, que não é a raiz nem um predecessor do objetoRelacionado.
A finalidade do evento rollOut é simplificar a codificação de comportamentos de rolagem para contêineres de objetos de exibição com filhos. Quando o mouse sair da área de um objeto de exibição ou da área de qualquer um dos seus filhos para ir até um objeto que não é um de seus filhos, o objeto de exibição despachará o evento rollOut. Trata-se de um comportamento diferente daquele do evento mouseOut, que é despachado sempre que o mouse sai da área de qualquer objeto-filho do contêiner de objetos de exibição, mesmo que o mouse permaneça sobre outro objeto-filho desse contêiner.
type de um objeto de evento rollOut.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | false |
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
relatedObject | O objeto da lista de exibição para o qual o dispositivo apontador aponta agora. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
rollOver | Evento |
flash.events.MouseEventpropriedade MouseEvent.type =
flash.events.MouseEvent.ROLL_OVER| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando o usuário move um dispositivo apontador sobre uma ocorrência InteractiveObject. O destino do evento é o objeto sob o dispositivo apontador ou um pai desse objeto. O objetoRelacionado é o objeto que estava anteriormente sob o dispositivo apontador. Os eventos rollOver são despachados consecutivamente para baixo na cadeia de pais do objeto, começando pelo pai mais alto, que não é a raiz nem um predecessor do objetoRelacionado, e terminando com o objeto.
A finalidade do evento rollOver é simplificar a codificação de comportamentos de rolagem para contêineres de objetos de exibição com filhos. Quando o mouse entrar na área de um objeto de exibição ou na área de qualquer um dos seus filhos a partir de um objeto que não é um de seus filhos, o objeto de exibição despachará o evento rollOver. Trata-se de um comportamento diferente daquele do evento mouseOver, que é despachado sempre que o mouse entra na área de qualquer objeto-filho do contêiner de objetos de exibição, mesmo que o mouse já tenha estado sobre outro objeto-filho desse contêiner.
type de um objeto de evento rollOver.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows). |
bubbles | false |
buttonDown | true se o botão principal do mouse estiver pressionado; false se não estiver. |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
relatedObject | O objeto da lista de exibição para o qual o dispositivo apontador estava apontando. |
localX | A coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
localY | A coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém, se o travamento de mouse estiver desativado. |
movementX | A modificação das coordenadas horizontais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
movementY | A modificação das coordenadas verticais da posição de mouse desde o último evento de mouse, se o travamento de mouse estiver ativado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo apontador. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
selectAll | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.SELECT_ALL| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10, AIR 1.5 |
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. Esse evento é despachado para o objeto com foco no momento. Se o objeto que no momento tem foco for um TextField, o comportamento padrão deste evento é fazer com que todo o conteúdo do campo de texto seja selecionado.
A constanteEvent.SELECT_ALL define o valor da propriedade type de um objeto de evento selectAll.
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 | Qualquer ocorrência do DisplayObject com um ouvinte registrado para o evento selectAll. |
Observação: Os objetos de TextField não despacham eventos apagar, copiar, recortar, colar ou selectAll. Os objetos de TextField sempre incluem comando Cortar, Copiar, Colar, Limpar e Selecionar tudo, no menu de contexto. Você não pode remover estes comandos do menu de contexto de objetos TextField. Para objetos TextField, selecionar estes comandos (ou os seus equivalentes de teclado) não gera eventos clear, copy, cut, paste, ou selectAll. No entanto, outras classes que estendem a classe InteractiveObject, incluindo os componentes criados com o Flash Text Engine (FTE), despacham estes eventos em resposta a ações do usuários como atalhos de teclado e menus de contexto.
softKeyboardActivate | Evento |
flash.events.SoftKeyboardEventpropriedade SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent. SOFT_KEYBOARD_ACTIVATE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.2, AIR 2.6 |
Despachado imediatamente depois que o teclado virtual é elevado.
Elementos da API relacionados
softKeyboardActivating | Evento |
flash.events.SoftKeyboardEventpropriedade SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent. SOFT_KEYBOARD_ACTIVATING| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.2, AIR 2.6 |
Despachado imediatamente antes de o teclado virtual ser elevado.
Elementos da API relacionados
softKeyboardDeactivate | Evento |
flash.events.SoftKeyboardEventpropriedade SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.2, AIR 2.6 |
Despachado imediatamente depois que o teclado virtual é baixado.
A constante SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE define o valor do objeto SoftKeyboardEvent da propriedade type quando um teclado virtual é abaixado ou ocultado. Para este evento, cancelável = false.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
tipo | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
relatedObjectVal | Uma referência a um objeto de lista de exibição relacionado ao evento. |
triggerTypeVal | Indica se o evento keyboard foi disparado pelo aplicativo ou pelo usuário. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
Elementos da API relacionados
tabChildrenChange | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.TAB_CHILDREN_CHANGE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9 |
Despachado quando o valor do sinalizador tabChildren do objeto é alterado.
Event.TAB_CHILDREN_CHANGE define o valor da propriedade type de um objeto de evento tabChildrenChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
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 cujo sinalizador tabChildren foi alterado. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
tabEnabledChange | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.TAB_ENABLED_CHANGE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9 |
Despachado quando o sinalizador tabEnabled do objeto é alterado.
Event.TAB_ENABLED_CHANGE define o valor da propriedade type de um objeto de evento tabEnabledChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
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 InteractiveObject cujo sinalizador tabEnabled foi alterado. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
tabIndexChange | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.TAB_INDEX_CHANGE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9 |
Despachado quando o valor da propriedade tabIndex do objeto é alterado.
Event.TAB_INDEX_CHANGE define o valor da propriedade type de um objeto de evento tabIndexChange.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
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 cujo tabIndex foi alterado. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
textInput | Evento |
flash.events.TextEventpropriedade TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Despachado quando um usuário introduz um ou vários caracteres do texto. Vários métodos de entrada de texto podem gerar esse evento, incluindo teclados padrão, IMEs (Editores de método de entrada), sistemas de reconhecimento de voz ou fala e até mesmo o ato de colar texto sem formatação ou informações de estilo.
Define o valor da propriedadetype de um objeto de evento textInput.
Observação: Este evento não é despachado para as teclas Excluir ou Backspace.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
cancelable | true; chama o método preventDefault() para cancelar o comportamento padrão. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
target | O campo de texto no qual os caracteres estão sendo inseridos. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
text | O caractere ou a string de caracteres inserida pelo usuário. |
touchBegin | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.TOUCH_BEGIN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Alguns dispositivos também podem interpretar este contato como um evento mouseDown.
Especificamente, se um usuário toca com um dedo uma tela sensível ao toque, a instância InteractiveObject pode despachar um evento mouseDown ou um evento touchBegin, ou ambos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o evento mouseDown, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e um dispositivo ativado pelo mouse. Contudo, se você escolher controlar o evento touchBegin, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor da propriedadetype de um objeto de evento de toque TOUCH_BEGIN.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
Exemplo ( Como usar este exemplo )
TOUCH_BEGIN, TOUCH_MOVE e TOUCH_END. Enquanto o ponto do contato se desloca pela tela (onTouchMove), a coordenada x relativa ao palco é traçada para a saída. Para os parâmetros Sprite.startTouchDrag na função onTouchBegin, o valor de touchPointID é o valor atribuído ao objeto de evento. O parâmetro de limites é o retângulo que define os limites do objeto de exibição pai (bg é um objeto de exibição que contém MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
Elementos da API relacionados
touchEnd | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.TOUCH_END| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Alguns dispositivos também podem interpretar este contato como um evento mouseUp.
Especificamente, se um usuário levanta um dedo de uma tela sensível ao toque, a instância InteractiveObject pode despachar um evento mouseUp ou um evento touchEnd, ou ambos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o evento mouseUp, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e um dispositivo ativado pelo mouse. Contudo, se você escolher controlar o evento touchEnd, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor da propriedadetype de um objeto de evento TOUCH_END.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
Exemplo ( Como usar este exemplo )
TOUCH_BEGIN, TOUCH_MOVE e TOUCH_END. Enquanto o ponto do contato se desloca pela tela (onTouchMove), a coordenada x relativa ao palco é traçada para a saída. Para os parâmetros Sprite.startTouchDrag na função onTouchBegin, o valor de touchPointID é o valor atribuído ao objeto de evento. O parâmetro de limites é o retângulo que define os limites do objeto de exibição pai (bg é um objeto de exibição que contém MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
Elementos da API relacionados
touchMove | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.TOUCH_MOVE| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Despachado quando o usuário toca o dispositivo, e é despachado continuamente até que o ponto contato seja removido. Observe que este evento não requer movimento do ponto de contato para ser despachado.
Alguns dispositivos podem interpretar este contato como um evento mouseMove. Especificamente, se um usuário move um dedo pela tela sensível ao toque, a instância InteractiveObject pode despachar um evento mouseMove ou um evento touchMove, ou ambos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o evento mouseMove, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e um dispositivo ativado pelo mouse. Contudo, se você escolher controlar o evento touchMove, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor da propriedadetype de um objeto de evento de toque TOUCH_MOVE.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
Exemplo ( Como usar este exemplo )
TOUCH_BEGIN, TOUCH_MOVE e TOUCH_END. Enquanto o ponto do contato se desloca pela tela (onTouchMove), a coordenada x relativa ao palco é traçada para a saída. Para os parâmetros Sprite.startTouchDrag na função onTouchBegin, o valor de touchPointID é o valor atribuído ao objeto de evento. O parâmetro de limites é o retângulo que define os limites do objeto de exibição pai (bg é um objeto de exibição que contém MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
Elementos da API relacionados
touchOut | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.TOUCH_OUT| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Alguns dispositivos também podem interpretar este contato como um evento mouseOut.
Especificamente, se um usuário move um dedo pela tela sensível ao toque, a instância InteractiveObject pode despachar um evento mouseOut ou um evento touchOut, ou ambos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o evento mouseOut, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e um dispositivo ativado pelo mouse. Contudo, se você escolher controlar o evento touchOut, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor da propriedadetype de um objeto de evento de toque TOUCH_OUT.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
Elementos da API relacionados
touchOver | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.TOUCH_OVER| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Alguns dispositivos também podem interpretar este contato como um evento mouseOver.
Especificamente, se um usuário move um dedo em InteractiveObject, a instância InteractiveObject pode despachar um evento mouseOver ou um evento touchOver, ou ambos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o evento mouseOver, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e em um dispositivo ativado pelo mouse. Contudo, se você escolher controlar o evento touchOver, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor da propriedadetype de um objeto de evento de toque TOUCH_OVER.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
Elementos da API relacionados
touchRollOut | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.TOUCH_ROLL_OUT| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Alguns dispositivos também podem interpretar este contato como um evento rollOut.
Especificamente, se um usuário move um dedo sobre InteractiveObject, a instância InteractiveObject pode despachar um evento rollOut ou um evento touchRollOut, ou ambos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o evento rollOut, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e um dispositivo ativado pelo mouse. Contudo, se você escolher controlar o evento touchRollOut, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor da propriedadetype de um objeto de evento de toque TOUCH_ROLL_OUT.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
Elementos da API relacionados
touchRollOver | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.TOUCH_ROLL_OVER| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Alguns dispositivos também podem interpretar este contato como um evento rollOver.
Especificamente, se um usuário move um dedo em InteractiveObject, a instância InteractiveObject pode despachar um evento rollOver ou um evento touchRollOver, ou ambos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o evento rollOver, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e um dispositivo ativado pelo mouse. Contudo, se você escolher controltar o evento touchRollOver, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor da propriedadetype de um objeto de evento de toque TOUCH_ROLL_OVER.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
Elementos da API relacionados
touchTap | Evento |
flash.events.TouchEventpropriedade TouchEvent.type =
flash.events.TouchEvent.TOUCH_TAP| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Alguns dispositivos também podem interpretar este contato como um evento click.
Especificamente, se um usuário toca com o dedo em InteractiveObject, a instância InteractiveObject pode despachar um evento click ou um evento touchTap, ou ambos se o ambiente atual suportar. Escolha como você quer controlar a interação do usuário. Use a classe flash.ui.Multitouch para gerenciar o controle de eventos de toque (ativar o controle de eventos de gesto de toque, o controle de eventos de ponto de toque simples, ou desativar eventos de toque para que somente eventos de mouse sejam despachados). Se você escolher controlar o evento click, então o mesmo controlador de eventos será executado em um dispositivo ativado pelo toque e um dispositivo ativado pelo mouse. Contudo, se você escolher controlar o evento touchTap, você pode projetar o seu controlador de eventos para responder às necessidades específicas de um ambiente ativado pelo toque e fornecer aos usuários uma experiência ativada pelo toque mais rica. Você também pode controlar ambos os eventos, separadamente, para fornecer uma resposta diferente para um evento de toque do que um evento de mouse.
Observação: consulte a classe de Multitoque para obter informações sobre a compatibilidade de ambiente.
Define o valor da propriedadetype de um objeto de evento de toque TOUCH_TAP.
O objeto TouchEvent despachado tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
altKey | true caso a tecla Alt esteja ativa (Windows ou Linux). |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
commandKey | true no Mac se a tecla Command estiver ativa; false se estiver inativa. Sempre false no Windows. |
controlKey | true se a tecla Ctrl ou Control estiver ativa; false se estiver inativa. |
ctrlKey | true no Windows ou no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
eventPhase | A fase atual no fluxo de eventos. |
isRelatedObjectInaccessible | true se a propriedade relatedObject for definida para null por causa de regras de área de segurança. |
localX | A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente. |
localY | A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente. |
pressão | Um valor entre 0.0 e 1.0 indicando força do contato com o dispositivo. Se o dispositivo não conseguir detectar a pressão, o valor será 1.0. |
relatedObject | Uma referência a um objeto de lista de exibição relacionado ao evento. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
sizeX | Largura da área de contato. |
sizeY | Altura da área de contato. |
stageX | A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco. |
stageY | A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco. |
target | A ocorrência InteractiveObject sob o dispositivo de toque. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
touchPointID | Um número de identificação exclusiva (como um int) destinado ao ponto de toque. |
Exemplo ( Como usar este exemplo )
Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT;
var mySprite:Sprite = new Sprite();
var myTextField:TextField = new TextField();
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0,0,40,40);
addChild(mySprite);
mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler);
function taphandler(e:TouchEvent): void {
myTextField.text = "I've been tapped";
myTextField.y = 50;
addChild(myTextField);
}
Elementos da API relacionados
InteractiveObjectExample, que, por sua vez, usa a classe ChildSprite para desenhar um retângulo e preenchê-lo com base em vários eventos de mouse. Essa tarefa é concluída com as seguintes etapas:
- No construtor
InteractiveObjectExample, um novo objeto ChildSprite do tipo Sprite denominadochildé criado, chamando o método do construtor ChildSprite para desenhar a forma e adicionar eventos de mouse para essa forma (conforme explicado nas etapas a seguir). O objeto-filhoé adicionado ao topo da lista de exibição, nas coordenadas x = 0, y = 0. - Na classe
ChildSprite, declare as propriedadessizeeoverSizeque serão usadas mais tarde no métododraw()e nos métodos MouseEvent. - Declare propriedades que definam a cor do plano de fundo como laranja, a cor de "mouse sobre" como preta e a cor de "mouse abaixo" como azul claro.
- No construtor
ChildSprite, um quadrado laranja é desenhado com o uso de métodos da classe Graphics e do métododraw(). - O construtor adiciona quatro métodos de ouvinte de eventos de MouseEvent:
mouseOverHandler: mouseOverHandler: redesenha um quadrado maior de 60 x 60 pixels com a cor amarelo-escuro nas coordenadas originais.mouseOutHandler: retorna o quadrado ao seu tamanho e cor originais.mouseDownHandler: redesenha um quadrado maior de 60 x 60 pixels com a cor azul-claro nas coordenadas originais.mouseUpHandler: o mesmo quemouseOverHandler.
package {
import flash.display.Sprite;
public class InteractiveObjectExample extends Sprite {
public function InteractiveObjectExample() {
var child:Sprite = new ChildSprite();
addChild(child);
}
}
}
import flash.display.Sprite;
import flash.events.MouseEvent;
class ChildSprite extends Sprite {
private var size:uint = 50;
private var overSize:uint = 60;
private var backgroundColor:uint = 0xFFCC00;
private var overColor:uint = 0xCCFF00;
private var downColor:uint = 0x00CCFF;
public function ChildSprite() {
buttonMode = true;
draw(size, size, backgroundColor);
addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
}
private function draw(w:uint, h:uint, bgColor:uint):void {
graphics.clear();
graphics.beginFill(bgColor);
graphics.drawRect(0, 0, w, h);
graphics.endFill();
}
public function mouseOverHandler(event:MouseEvent):void {
trace("mouseOverHandler");
draw(overSize, overSize, overColor);
}
public function mouseOutHandler(event:MouseEvent):void {
trace("mouseOutHandler");
draw(size, size, backgroundColor);
}
public function mouseDownHandler(event:MouseEvent):void {
trace("mouseDownHandler");
draw(overSize, overSize, downColor);
}
public function mouseUpHandler(event:MouseEvent):void {
trace("mouseUpHandler");
draw(overSize, overSize, overColor);
}
}
Wed Jun 13 2018, 11:10 AM Z