| Pacote | flash.events |
| Classe | public class KeyboardEvent |
| Herança | KeyboardEvent Event Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
KeyboardEvent.KEY_DOWN e KeyboardEvent.KEY_UP
Como o mapeamento entre teclas e caracteres específicos varia em função do dispositivo e sistema operacional, use o tipo de evento TextEvent para processar a entrada de caracteres.
Para escutar eventos de tecla globalmente, escute no palco pela fase de captura e de destino ou de bubble.
Mais exemplos
Handling keyboard events
Understanding the keyCode and charCode properties
Understanding KeyboardEvent precedence
Elementos da API relacionados
| Propriedade | Definido por | ||
|---|---|---|---|
| altKey : Boolean
Indica se a tecla Alt está ativa (true) ou inativa (false) no Windows; indica se a tecla Option está ativa no Mac OS. | KeyboardEvent | ||
![]() | bubbles : Boolean [somente leitura]
Indica se um evento é do tipo bubbling. | Event | |
![]() | cancelable : Boolean [somente leitura]
Indica se o comportamento associado ao evento pode ser impedido. | Event | |
| charCode : uint
Contém o valor de código de caractere da tecla pressionada ou solta. | KeyboardEvent | ||
| commandKey : Boolean
Indica se a tecla Command está ativa (true) ou inativa (false). | KeyboardEvent | ||
![]() | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| controlKey : Boolean
Indica se a tecla Control está ativa (true) ou inativa (false). | KeyboardEvent | ||
| ctrlKey : Boolean
No Windows e no Linux, indica se a tecla Ctrl está ativa (true) ou inativa (false); No Mac OS, indica se a tecla Ctrl ou a tecla Command está ativa. | KeyboardEvent | ||
![]() | currentTarget : Object [somente leitura]
O objeto que está processando ativamente o objeto Event com um ouvinte de evento. | Event | |
![]() | eventPhase : uint [somente leitura]
A fase atual no fluxo de eventos. | Event | |
| keyCode : uint
O valor de código da tecla pressionada ou solta. | KeyboardEvent | ||
| keyLocation : uint
Indica a localização da tecla no teclado. | KeyboardEvent | ||
| shiftKey : Boolean
Indica se o modificador da tecla Shift está ativo (true) ou inativo (false). | KeyboardEvent | ||
![]() | target : Object [somente leitura]
O destino de evento. | Event | |
![]() | type : String [somente leitura]
O tipo de evento. | Event | |
| Método | Definido por | ||
|---|---|---|---|
KeyboardEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, charCodeValue:uint = 0, keyCodeValue:uint = 0, keyLocationValue:uint = 0, ctrlKeyValue:Boolean = false, altKeyValue:Boolean = false, shiftKeyValue:Boolean = false, controlKeyValue:Boolean = false, commandKeyValue:Boolean = false)
Cria um objeto Event que contém informações sobre eventos de teclado. | KeyboardEvent | ||
[substituir]
Cria uma cópia do objeto KeyboardEvent e define o valor de cada propriedade para corresponder ao do original. | KeyboardEvent | ||
![]() |
Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas. | Event | |
![]() |
Indica se um objeto tem uma propriedade especificada definida. | Object | |
![]() |
Verifica se o método preventDefault() foi chamado no evento. | Event | |
![]() |
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
![]() |
Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado. | Event | |
![]() |
Indica se a propriedade especificada existe e é enumerável. | Object | |
![]() |
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
![]() |
Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos. | Event | |
![]() |
Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos. | Event | |
![]() |
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
[substituir]
Retorna uma string que contém todas as propriedades do objeto KeyboardEvent. | KeyboardEvent | ||
Indica se deve ser aplicado acabamento na exibição após o término do processamento desse evento, se a lista de exibição tiver sido modificada
| KeyboardEvent | ||
![]() |
Retorna o valor primitivo do objeto especificado. | Object | |
| Constante | Definido por | ||
|---|---|---|---|
| KEY_DOWN : String = "keyDown" [estático]
A constante The KeyboardEvent.KEY_DOWN define o valor da propriedade type de um objeto de evento keyDown. | KeyboardEvent | ||
| KEY_UP : String = "keyUp" [estático]
A constante KeyboardEvent.KEY_UP define o valor da propriedade type de um objeto de evento keyUp. | KeyboardEvent | ||
altKey | propriedade |
altKey:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9 |
Indica se a tecla Alt está ativa (true) ou inativa (false) no Windows; indica se a tecla Option está ativa no Mac OS.
Implementação
public function get altKey():Boolean public function set altKey(value:Boolean):voidcharCode | propriedade |
charCode:uint| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Contém o valor de código de caractere da tecla pressionada ou solta. Os valores de código de caracteres retornados são valores de teclado inglês. Por exemplo, se você pressionar Shift+3, charCode será um número em um teclado japonês. Se você pressionar Shift+2, charCode será @ em um teclado alemão (não "), assim como no teclado americano.
Observação: quando um editor de métodos de entrada (IME) estiver sendo executado, o charCode não reportará códigos de caracteres exatos.
Implementação
public function get charCode():uint public function set charCode(value:uint):voidcommandKey | propriedade |
commandKey:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Indica se a tecla Command está ativa (true) ou inativa (false). Com suporte somente no Mac OS. No Mac OS, a propriedade commandKey tem o mesmo valor que a propriedade ctrlKey.
Implementação
public function get commandKey():Boolean public function set commandKey(value:Boolean):voidcontrolKey | propriedade |
controlKey:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Lite 4 |
Indica se a tecla Control está ativa (true) ou inativa (false). No Windows e no Linux, isso também é true quando a tecla Ctrl está ativa.
Implementação
public function get controlKey():Boolean public function set controlKey(value:Boolean):voidctrlKey | propriedade |
ctrlKey:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9 |
No Windows e no Linux, indica se a tecla Ctrl está ativa (true) ou inativa (false); No Mac OS, indica se a tecla Ctrl ou a tecla Command está ativa.
Implementação
public function get ctrlKey():Boolean public function set ctrlKey(value:Boolean):voidkeyCode | propriedade |
keyCode:uint| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
O valor de código da tecla pressionada ou solta.
Observação: Quando um editor de métodos de entrada (IME) estiver sendo executado, o keyCode não reportará códigos de caracteres exatos.
Implementação
public function get keyCode():uint public function set keyCode(value:uint):voidElementos da API relacionados
keyLocation | propriedade |
keyLocation:uint| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica a localização da tecla no teclado. Isto é útil para diferenciar teclas que aparecem mais de uma vez no teclado. Por exemplo, você pode diferenciar entre as teclas Shift direita e esquerda pelo valor desta propriedade: KeyLocation.LEFT para a esquerda e KeyLocation.RIGHT para a direita. Outro exemplo é a diferenciação entre teclas de números pressionadas no teclado padrão (KeyLocation.STANDARD) e no teclado numérico (KeyLocation.NUM_PAD).
Implementação
public function get keyLocation():uint public function set keyLocation(value:uint):voidshiftKey | propriedade |
KeyboardEvent | () | Construtor |
public function KeyboardEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, charCodeValue:uint = 0, keyCodeValue:uint = 0, keyLocationValue:uint = 0, ctrlKeyValue:Boolean = false, altKeyValue:Boolean = false, shiftKeyValue:Boolean = false, controlKeyValue:Boolean = false, commandKeyValue:Boolean = false)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cria um objeto Event que contém informações sobre eventos de teclado. Objetos Event são transmitidos como parâmetros para ouvintes de eventos.
Parâmetrostype:String — O tipo de evento. São estes os valores possíveis: KeyboardEvent.KEY_DOWN e KeyboardEvent.KEY_UP
| |
bubbles:Boolean (default = true) — Determina se o objeto Event participa do estágio de bubbling do fluxo de eventos.
| |
cancelable:Boolean (default = false) — Determina se o objeto Event pode ser cancelado.
| |
charCodeValue:uint (default = 0) — O valor de código de caractere da tecla pressionada ou solta. Os valores de código de caracteres retornados são valores de teclado inglês. Por exemplo, se você pressionar Shift+3, a propriedade Keyboard.charCode() retornará um número em um teclado em japonês ou alemão da mesma forma como acontece em um teclado em inglês.
| |
keyCodeValue:uint (default = 0) — O valor de código da tecla pressionada ou solta.
| |
keyLocationValue:uint (default = 0) — O local da tecla no teclado.
| |
ctrlKeyValue:Boolean (default = false) — No Windows, indica se a tecla Control está ativada. No Mac, indica se a tecla Ctrl ou se a tecla Command está ativada.
| |
altKeyValue:Boolean (default = false) — Indica se o modificador da tecla Alt está ativado (só no Windows).
| |
shiftKeyValue:Boolean (default = false) — Indica se o modificador da tecla Shift está ativado.
| |
controlKeyValue:Boolean (default = false) — Indica se a tecla Control está ativada no Mac e se a tecla Control ou Ctrl está ativada no Windows e no Linux.
| |
commandKeyValue:Boolean (default = false) — Indica se a tecla Command está ativada (só no Mac).
|
Elementos da API relacionados
clone | () | método |
override public function clone():Event| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cria uma cópia do objeto KeyboardEvent e define o valor de cada propriedade para corresponder ao do original.
RetornaEvent — Um novo objeto KeyboardEvent com valores de propriedade que correspondem aos do original.
|
toString | () | método |
override public function toString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Retorna uma string que contém todas as propriedades do objeto KeyboardEvent. A string está no seguinte formato:
[KeyboardEvent type=value bubbles=value cancelable=value ... shiftKey=value]
String — Uma string que contém todas as propriedades do objeto KeyboardEvent.
|
updateAfterEvent | () | método |
public function updateAfterEvent():void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9 |
Indica se deve ser aplicado acabamento na exibição após o término do processamento desse evento, se a lista de exibição tiver sido modificada
KEY_DOWN | Constante |
public static const KEY_DOWN:String = "keyDown"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante KeyboardEvent.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. |
Elementos da API relacionados
KEY_UP | Constante |
public static const KEY_UP:String = "keyUp"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A constante 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. |
Elementos da API relacionados
KeyboardEventExample para mostrar eventos keyboard e suas funções de ouvinte. O exemplo executa as seguintes tarefas:
- Ele cria uma nova ocorrência Sprite com o nome
child. - Ele declara propriedades para uso posterior na definição de cor e tamanho do plano de fundo do quadrado.
- Usando métodos de Sprite, ele desenha um quadrado azul claro que é exibido no palco em coordenadas padrão (0,0) chamando o método
addChild(). - Adiciona um evento mouse e dois ouvintes de evento do tipo keyboard:
click/clickHandlerque é despachado quando você clica no quadrado para definir o foco na entidade gráficachildde forma que ele possa ouvir os eventos de teclado.keyDown/keyDownHandler, despachado sempre que uma tecla é pressionada. O método de assinante imprime informações sobre o evento usando a instruçãotrace().keyUp/keyUpHandler, despachado quando uma tecla é solta.
Quando você testa esse exemplo, é necessário clicar primeiro no quadrado para que os eventos de teclado funcionem.
Além disso, se você estiver usando o comando Filme de Teste no Flash, a interface de autoria poderá responder a determinadas teclas em vez de aos ouvintes de eventos anexados à entidade gráfica filha.
package {
import flash.display.Sprite;
import flash.display.DisplayObject;
import flash.events.*;
public class KeyboardEventExample extends Sprite {
private var child:Sprite = new Sprite();
private var bgColor:uint = 0x00CCFF;
private var size:uint = 80;
public function KeyboardEventExample() {
child.graphics.beginFill(bgColor);
child.graphics.drawRect(0, 0, size, size);
child.graphics.endFill();
addChild(child);
child.addEventListener(MouseEvent.CLICK, clickHandler);
child.addEventListener(KeyboardEvent.KEY_DOWN, keyDownHandler);
child.addEventListener(KeyboardEvent.KEY_UP, keyUpHandler);
}
private function clickHandler(event:MouseEvent):void {
stage.focus = child;
}
private function keyDownHandler(event:KeyboardEvent):void {
trace("keyDownHandler: " + event.keyCode);
trace("ctrlKey: " + event.ctrlKey);
trace("keyLocation: " + event.keyLocation);
trace("shiftKey: " + event.shiftKey);
trace("altKey: " + event.altKey);
}
private function keyUpHandler(event:KeyboardEvent):void {
trace("keyUpHandler: " + event.keyCode);
}
}
}
Wed Jun 13 2018, 11:10 AM Z
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas