Paquete | flash.events |
Clase | public class KeyboardEvent |
Herencia | KeyboardEvent Event Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
KeyboardEvent.KEY_DOWN
y KeyboardEvent.KEY_UP
Como las asignaciones entre teclas y caracteres especiales varía en función del dispositivo y el sistema operativo, utilice el tipo de evento TextEvent para procesar la introducción de caracteres.
Para detectar eventos de teclas de forma global, realice la detección en el escenario en las fases de captura y destino o de propagación.
Más ejemplos
Handling keyboard events
Understanding the keyCode and charCode properties
Understanding KeyboardEvent precedence
Elementos de API relacionados
Propiedad | Definido por | ||
---|---|---|---|
altKey : Boolean
Indica si la tecla Alt está activa (true) o inactiva (false) en Windows; indica si la tecla Opción está activa en Mac OS. | KeyboardEvent | ||
bubbles : Boolean [solo lectura]
Indica si un evento es un evento de propagación. | Event | ||
cancelable : Boolean [solo lectura]
Indica si se puede evitar el comportamiento asociado al evento. | Event | ||
charCode : uint
Contiene el valor de código de carácter de la tecla presionada o soltada. | KeyboardEvent | ||
commandKey : Boolean
Indica si la tecla Comando está activa (true) o inactiva (false). | KeyboardEvent | ||
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
controlKey : Boolean
Indica si la tecla Control está activa (true) o inactiva (false). | KeyboardEvent | ||
ctrlKey : Boolean
En Windows y Linux, indica si la tecla Ctrl está activa (true) o inactiva (false). En Mac OS, indica si la tecla Ctrl o la tecla Comando está activa. | KeyboardEvent | ||
currentTarget : Object [solo lectura]
Objeto que procesa de forma activa el objeto de evento con un detector de eventos. | Event | ||
eventPhase : uint [solo lectura]
La fase actual en el flujo del evento. | Event | ||
keyCode : uint
El valor de código de tecla de la tecla presionada o soltada. | KeyboardEvent | ||
keyLocation : uint
Indica la ubicación de la tecla en el teclado. | KeyboardEvent | ||
shiftKey : Boolean
Indica si el modificador de la tecla Mayús está activo (true) o inactivo (false). | KeyboardEvent | ||
target : Object [solo lectura]
El destino del evento. | Event | ||
type : String [solo lectura]
El 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)
Crea un objeto de evento que contiene información específica sobre eventos de teclado. | KeyboardEvent | ||
[override]
Crea una copia del objeto KeyboardEvent y define el valor de cada propiedad para que coincida con el del objeto original. | KeyboardEvent | ||
Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0. | Event | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Comprueba si se ha llamado a preventDefault() en el evento. | Event | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo. | Event | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento. | Event | ||
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual. | Event | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
[override]
Devuelve una cadena con todas las propiedades del objeto KeyboardEvent. | KeyboardEvent | ||
Indica que la visualización debe representarse tras finalizar el procesamiento de este evento, en caso de haber modificado la lista de visualización
| KeyboardEvent | ||
Devuelve el valor simple del objeto especificado. | Object |
Constante | Definido por | ||
---|---|---|---|
KEY_DOWN : String = "keyDown" [estática]
La constante KeyboardEvent.KEY_DOWN define el valor de la propiedad type de un objeto de evento keyDown. | KeyboardEvent | ||
KEY_UP : String = "keyUp" [estática]
La constante KeyboardEvent.KEY_UP define el valor de la propiedad type de un objeto de evento keyUp. | KeyboardEvent |
altKey | propiedad |
altKey:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Indica si la tecla Alt está activa (true
) o inactiva (false
) en Windows; indica si la tecla Opción está activa en Mac OS.
Implementación
public function get altKey():Boolean
public function set altKey(value:Boolean):void
charCode | propiedad |
charCode:uint
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Contiene el valor de código de carácter de la tecla presionada o soltada. Los valores de códigos de caracteres son los correspondientes a un teclado inglés. Por ejemplo, si pulsa Mayús+3, charCode
es # en un teclado japonés, si pulsa Mayúst+2, charCode
es @ en un teclado alemán (y no "), tal y como sucede en un teclado inglés.
Nota: Si se ejecuta un editor de método de entrada (IME), charCode
no informa con precisión sobre los códigos de caracteres.
Implementación
public function get charCode():uint
public function set charCode(value:uint):void
commandKey | propiedad |
commandKey:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Indica si la tecla Comando está activa (true
) o inactiva (false
). Sólo se admite en Mac OS. En Mac OS, las propiedades commandKey
y ctrlKey
tienen el mismo valor.
Implementación
public function get commandKey():Boolean
public function set commandKey(value:Boolean):void
controlKey | propiedad |
controlKey:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Indica si la tecla Control está activa (true
) o inactiva (false
). En Windows y Linux, también es true si la tecla Ctrl está activa.
Implementación
public function get controlKey():Boolean
public function set controlKey(value:Boolean):void
ctrlKey | propiedad |
ctrlKey:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
En Windows y Linux, indica si la tecla Ctrl está activa (true
) o inactiva (false
). En Mac OS, indica si la tecla Ctrl o la tecla Comando está activa.
Implementación
public function get ctrlKey():Boolean
public function set ctrlKey(value:Boolean):void
keyCode | propiedad |
keyCode:uint
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
El valor de código de tecla de la tecla presionada o soltada.
Nota: si se ejecuta un editor de método de entrada (IME), keyCode
no informa con precisión sobre los códigos de teclas.
Implementación
public function get keyCode():uint
public function set keyCode(value:uint):void
Elementos de API relacionados
keyLocation | propiedad |
keyLocation:uint
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica la ubicación de la tecla en el teclado. Resulta útil para distinguir las teclas que aparecen más de una vez en un teclado. Por ejemplo, es posible distinguir entre las teclas Mayús izquierda y derecha según el valor de esta propiedad: KeyLocation.LEFT
para la izquierda y KeyLocation.RIGHT
para la derecha. Otro ejemplo sería distinguir entre las teclas numéricas pulsadas en el teclado estándar (KeyLocation.STANDARD
) y las pulsadas en el teclado numérico (KeyLocation.NUM_PAD
).
Implementación
public function get keyLocation():uint
public function set keyLocation(value:uint):void
shiftKey | propiedad |
KeyboardEvent | () | Información sobre |
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)
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea un objeto de evento que contiene información específica sobre eventos de teclado. Los objetos de evento se transfieren como parámetros a los detectores de eventos.
Parámetrostype:String — El tipo de evento. Los valores posibles son: KeyboardEvent.KEY_DOWN y KeyboardEvent.KEY_UP
| |
bubbles:Boolean (default = true ) — Determina si el objeto de evento participa en la fase de propagación del flujo del evento.
| |
cancelable:Boolean (default = false ) — Determina si se puede cancelar el objeto Event.
| |
charCodeValue:uint (default = 0 ) — El valor de código de carácter de la tecla presionada o soltada. Los valores de códigos de caracteres devueltos son los correspondientes a un teclado inglés. Por ejemplo, si pulsa Mayús+3, la propiedad Keyboard.charCode() devuelve # en un teclado japonés o alemán, igual que en un teclado inglés.
| |
keyCodeValue:uint (default = 0 ) — El valor de código de tecla de la tecla presionada o soltada.
| |
keyLocationValue:uint (default = 0 ) — La ubicación de la tecla en el teclado.
| |
ctrlKeyValue:Boolean (default = false ) — En Windows, indica está activada la tecla Ctrl. En Mac, indica si está activada la tecla Ctrl o Comando.
| |
altKeyValue:Boolean (default = false ) — Indica si el modificador de la tecla Alt está activado (sólo Windows).
| |
shiftKeyValue:Boolean (default = false ) — Indica si el modificador de la tecla Mayús está activado.
| |
controlKeyValue:Boolean (default = false ) — Indica si la tecla Control está activada en Mac, y si las teclas Control o Ctrl están activadas en Windows y Linux.
| |
commandKeyValue:Boolean (default = false ) — Indica si la tecla Comando está activada (sólo en Mac).
|
Elementos de API relacionados
clone | () | método |
override public function clone():Event
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea una copia del objeto KeyboardEvent y define el valor de cada propiedad para que coincida con el del objeto original.
Valor devueltoEvent — Un nuevo objeto KeyboardEvent con valores de propiedades que coinciden con los del objeto original.
|
toString | () | método |
override public function toString():String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve una cadena con todas las propiedades del objeto KeyboardEvent. La cadena tiene el siguiente formato:
[tipo KeyboardEvent= valor bubbles= valor cancelable= valor ... shiftKey= valor]
String — Una cadena que contiene todas las propiedades del objeto KeyboardEvent.
|
updateAfterEvent | () | método |
public function updateAfterEvent():void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Indica que la visualización debe representarse tras finalizar el procesamiento de este evento, en caso de haber modificado la lista de visualización
KEY_DOWN | Constante |
public static const KEY_DOWN:String = "keyDown"
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La constante KeyboardEvent.KEY_DOWN
define el valor de la propiedad type
de un objeto de evento keyDown
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | true |
cancelable | true en AIR, false en Flash Player; en AIR, cancelar este evento impide que se puedan introducir caracteres en un campo de texto. |
charCode | El valor de código de carácter de la tecla presionada o soltada. |
commandKey | true en Mac si la tecla Comando está activa. En caso contrario, false |
controlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac si la tecla Control está activa. En caso contrario, false |
ctrlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false . |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | El valor de código de tecla de la tecla presionada o soltada. |
keyLocation | La ubicación de la tecla en el teclado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia InteractiveObject que está seleccionada. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
Elementos de API relacionados
KEY_UP | Constante |
public static const KEY_UP:String = "keyUp"
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La constante KeyboardEvent.KEY_UP
define el valor de la propiedad type
de un objeto de evento keyUp
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | true |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
charCode | Contiene el valor de código de carácter de la tecla presionada o soltada. |
commandKey | true en Mac si la tecla Comando está activa. En caso contrario, false |
controlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac si la tecla Control está activa. En caso contrario, false |
ctrlKey | true en Windows, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false . |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | El valor de código de tecla de la tecla presionada o soltada. |
keyLocation | La ubicación de la tecla en el teclado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia InteractiveObject que está seleccionada. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
Elementos de API relacionados
KeyboardEventExample
para mostrar eventos de teclado y sus funciones detectoras. El ejemplo realiza las siguientes tareas:
- Crea una nueva instancia de Sprite llamada
child
. - Declara propiedades para su uso posterior en la definición del color de fondo y el tamaño de un cuadrado.
- Con los métodos de Sprite, dibuja un cuadrado azul claro que se muestra en las coordenadas predeterminadas (0,0) del escenario mediante la llamada al método
addChild()
. - Añade un evento mouse y dos detectores de eventos de tipo keyboard:
click
/clickHandler
, que se distribuye al hacer clic en el recuadro para definir la selección en el elemento Spritesecundario
y que pueda detectar eventos keyboard.keyDown
/keyDownHandler
que se distribuyen siempre que se pulsa una tecla. El método suscriptor imprime información sobre el evento utilizando la sentenciatrace()
.keyUp
/keyUpHandler
que se distribuye al soltar una tecla.
Para probar este ejemplo es necesario hacer clic primero en el recuadro para que funcionen los eventos keyboard.
Asimismo, si utiliza el comando Probar película en Flash, la interfaz de creación puede responder a ciertas teclas en vez de a los detectores de eventos asociados al objeto Sprite secundario.
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); } } }
Tue Jun 12 2018, 02:12 PM Z