InteractiveObject  - AS3

A implementação de acessibilidade atual (AccessibilityImplementation) para esta instância do InteractiveObject.

Elementos da API relacionados

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.

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

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.

Elementos da API relacionados

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.

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.

Elementos da API relacionados

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.

Elementos da API relacionados

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.

Elementos da API relacionados

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.

Elementos da API relacionados

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.

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;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

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()

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.

Elementos da API relacionados

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.

Esse evento tem as seguintes propriedades:

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.

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

Esse evento tem as seguintes propriedades:

Despachado quando uma ação do usuário seleciona o menu de contexto associado a esse objeto interativo em um aplicativo do AIR.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

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.

Esse evento tem as seguintes propriedades:

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.

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.

Esse evento tem as seguintes propriedades:

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.

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.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

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.

Esse evento tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades:

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.

O objeto TransformGestureEvent despachado tem as seguintes propriedades:

Elementos da API relacionados

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

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.

O objeto TransformGestureEvent despachado tem as seguintes propriedades:

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

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.

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:

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

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.

O objeto TransformGestureEvent despachado tem as seguintes propriedades:

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

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

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.

O objeto TransformGestureEvent despachado tem as seguintes propriedades:

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

Este evento é despachado para qualquer aplicativo cliente que suporte a entrada incorporada com um IME

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.

Esse evento tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades:

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:

Esse evento tem as seguintes propriedades:

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

Esse evento tem as seguintes propriedades:

Despachado quando o usuário pressiona o botão do meio do dispositivo apontador sobre uma ocorrência InteractiveObject.

Esse evento tem as seguintes propriedades:

Despachado quando o usuário libera o botão do dispositivo apontador sobre uma ocorrência InteractiveObject.

Esse evento tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades: