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):void
charCode | 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):void
commandKey | 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):void
controlKey | 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):void
ctrlKey | 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):void
keyCode | 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):void
Elementos 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):void
shiftKey | 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
/clickHandler
que é despachado quando você clica no quadrado para definir o foco na entidade gráficachild
de 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