Paqueteflash.events
Clasepublic class KeyboardEvent
HerenciaKeyboardEvent Inheritance Event Inheritance Object

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Flash® Player distribuye objetos KeyboardEvent como respuesta a la entrada del usuario mediante el teclado. Existen dos tipos de eventos de teclado: 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.

Ver los ejemplos

Véase también

KEY_DOWN
KEY_UP
KeyLocation


Propiedades públicas
 PropiedadDefinido por
  altKey : Boolean
Indica si la tecla Alt está activa (true) o inactiva (false).
KeyboardEvent
 Inheritedbubbles : Boolean
[read-only] Indica si un evento es un evento de propagación.
Event
 Inheritedcancelable : Boolean
[read-only] 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
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  ctrlKey : Boolean
Indica si la tecla Control está activa (true) o inactiva (false).
KeyboardEvent
 InheritedcurrentTarget : Object
[read-only] El objeto que procesa de forma activa el objeto de evento con un detector de eventos.
Event
 InheritedeventPhase : uint
[read-only] 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
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  shiftKey : Boolean
Indica si el modificador de la tecla Mayús está activo (true) o inactivo (false).
KeyboardEvent
 Inheritedtarget : Object
[read-only] El destino del evento.
Event
 Inheritedtype : String
[read-only] El tipo de evento.
Event
Métodos públicos
 MétodoDefinido por
  
KeyboardEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, charCode:uint = 0, keyCode:uint = 0, keyLocation:uint = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false)
Crea un objeto de evento que contiene información específica sobre eventos de teclado.
KeyboardEvent
  
Crea una copia del objeto KeyboardEvent y define el valor de cada propiedad para que coincida con el del objeto original.
KeyboardEvent
 Inherited
formatToString(className:String, ... arguments):String
Una función de utilidad para implementar el método toString() en la clase Event personalizada.
Event
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Comprueba si se ha llamado a preventDefault() en el evento.
Event
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo.
Event
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento.
Event
 Inherited
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual.
Event
  
Devuelve una cadena con todas las propiedades del objeto KeyboardEvent.
KeyboardEvent
  
Si se ha modificado la lista de visualización, da instrucciones a Flash Player para que muestre la representación tras finalizar el procesamiento del evento.
KeyboardEvent
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Constantes públicas
 ConstanteDefinido por
 InheritedACTIVATE : String = "activate"
[static] Define el valor de la propiedad type para un objeto de evento activate.
Event
 InheritedADDED : String = "added"
[static] Define el valor de la propiedad type para un objeto de evento added.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] Define el valor de la propiedad type para un objeto de evento addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[static] Define el valor de la propiedad type para un objeto de evento cancel.
Event
 InheritedCHANGE : String = "change"
[static] Define el valor de la propiedad type para un objeto de evento change.
Event
 InheritedCLOSE : String = "close"
[static] Define el valor de la propiedad type para un objeto de evento close.
Event
 InheritedCOMPLETE : String = "complete"
[static] Define el valor de la propiedad type para un objeto de evento complete.
Event
 InheritedCONNECT : String = "connect"
[static] Define el valor de la propiedad type para un objeto de evento connect.
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] Define el valor de la propiedad type para un objeto de evento deactivate.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] Define el valor de la propiedad type para un objeto de evento enterFrame.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[static] Define el valor de la propiedad type para un objeto de evento fullScreen.
Event
 InheritedID3 : String = "id3"
[static] Define el valor de la propiedad type para un objeto de evento id3.
Event
 InheritedINIT : String = "init"
[static] Define el valor de la propiedad type para un objeto de evento init.
Event
  KEY_DOWN : String = "keyDown"
[static] Define el valor de la propiedad type para un objeto de evento keyDown.
KeyboardEvent
  KEY_UP : String = "keyUp"
[static] Define el valor de la propiedad type para un objeto de evento keyUp.
KeyboardEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Define el valor de la propiedad type para un objeto de evento mouseLeave.
Event
 InheritedOPEN : String = "open"
[static] Define el valor de la propiedad type para un objeto de evento open.
Event
 InheritedREMOVED : String = "removed"
[static] Define el valor de la propiedad type para un objeto de evento removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] Define el valor de la propiedad type para un objeto de evento removedFromStage.
Event
 InheritedRENDER : String = "render"
[static] Define el valor de la propiedad type para un objeto de evento render.
Event
 InheritedRESIZE : String = "resize"
[static] Define el valor de la propiedad type para un objeto de evento resize.
Event
 InheritedSCROLL : String = "scroll"
[static] Define el valor de la propiedad type para un objeto de evento scroll.
Event
 InheritedSELECT : String = "select"
[static] Define el valor de la propiedad type para un objeto de evento select.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] Define el valor de la propiedad type para un objeto de evento soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] Define el valor de la propiedad type para un objeto de evento tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] Define el valor de la propiedad type para un objeto de evento tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] Define el valor de la propiedad type para un objeto de evento tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[static] Define el valor de la propiedad type para un objeto de evento unload.
Event
Información sobre propiedades
altKeypropiedad
altKey:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Indica si la tecla Alt está activa (true) o inactiva (false). Sólo se admite en los sistema operativos Windows.


Implementación
    public function get altKey():Boolean
    public function set altKey(value:Boolean):void
charCodepropiedad 
charCode:uint  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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 presiona Mayús+3, charCode será # en un teclado japonés, que es el mismo resultado que 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

Véase también

ctrlKeypropiedad 
ctrlKey:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Indica si la tecla Control está activa (true) o inactiva (false).

Nota: el modificador de la tecla Comando de los sistemas Macintosh debe representarse con este modificador de tecla.


Implementación
    public function get ctrlKey():Boolean
    public function set ctrlKey(value:Boolean):void
keyCodepropiedad 
keyCode:uint  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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

Véase también

keyLocationpropiedad 
keyLocation:uint  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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
shiftKeypropiedad 
shiftKey:Boolean  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Indica si el modificador de la tecla Mayús está activo (true) o inactivo (false).


Implementación
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean):void
Información sobre constructores
KeyboardEvent()constructor
public function KeyboardEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, charCode:uint = 0, keyCode:uint = 0, keyLocation:uint = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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ámetros
type: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.
 
charCode: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 presiona Mayús+3, el método getASCIICode() devolverá # en un teclado japonés, que es el mismo resultado que en un teclado inglés.
 
keyCode:uint (default = 0) — El valor de código de tecla de la tecla presionada o soltada.
 
keyLocation:uint (default = 0) — La ubicación de la tecla en el teclado.
 
ctrlKey:Boolean (default = false) — Indica si el modificador de la tecla Control está activado.
 
altKey:Boolean (default = false) — Indica si el modificador de la tecla Alt está activado (sólo Windows).
 
shiftKey:Boolean (default = false) — Indica si el modificador de la tecla Mayús está activado.

Véase también

Información sobre métodos
clone()método
public override function clone():Event

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea una copia del objeto KeyboardEvent y define el valor de cada propiedad para que coincida con el del objeto original.

Valor devuelto
Event — Un nuevo objeto KeyboardEvent con valores de propiedades que coinciden con los del objeto original.
toString()método 
public override function toString():String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

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]

Valor devuelto
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
Versión del reproductor: Flash Player 9

Si se ha modificado la lista de visualización, da instrucciones a Flash Player para que muestre la representación tras finalizar el procesamiento del evento.

Información sobre constantes
KEY_DOWNConstante
public static const KEY_DOWN:String = "keyDown"

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Define el valor de la propiedad type de un objeto de evento keyDown.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblestrue
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
charCodeEl valor de código de carácter de la tecla presionada o soltada.
ctrlKeytrue si la tecla Control está activa; false si está inactiva.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
keyCodeEl valor de código de tecla de la tecla presionada o soltada.
keyLocationLa ubicación de la tecla en el teclado.
shiftKeytrue si la tecla Mayús está activa; false si está inactiva.
targetLa 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.

Véase también

KEY_UPConstante 
public static const KEY_UP:String = "keyUp"

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Define el valor de la propiedad type de un objeto de evento keyUp.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblestrue
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
charCodeContiene el valor de código de carácter de la tecla presionada o soltada.
ctrlKeytrue si la tecla Control está activa; false si está inactiva.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
keyCodeEl valor de código de tecla de la tecla presionada o soltada.
keyLocationLa ubicación de la tecla en el teclado.
shiftKeytrue si la tecla Mayús está activa; false si está inactiva.
targetLa 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.

Véase también

Ejemplos Cómo utilizar los ejemplos
KeyboardEventExample.as

En el ejemplo siguiente, se utiliza la clase KeyboardEventExample para mostrar eventos de teclado y sus funciones detectoras. El ejemplo realiza las siguientes tareas:
  1. Declara propiedades para su uso posterior en la definición del color de fondo y el tamaño de un cuadrado.
  2. Crea una nueva instancia de Sprite llamada child.
  3. 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().
  4. Añade dos detectores de eventos de teclado:
    • keyDown/keyDownHandler que se distribuyen siempre que se pulsa una tecla. El método suscriptor imprime información sobre el evento utilizando la sentencia trace().
    • keyUp/keyUpHandler que se distribuye al soltar una tecla.

En algunos casos tal vez sea necesario hacer clic en el escenario para que funcionen los eventos de teclado.

package {
    import flash.display.Sprite;
    import flash.display.DisplayObject;
    import flash.events.*;

    public class KeyboardEventExample extends Sprite {
        private var bgColor:uint = 0x00CCFF;
        private var size:uint = 80;

        public function KeyboardEventExample() {
            var child:Sprite = new Sprite();
            child.graphics.beginFill(bgColor);
            child.graphics.drawRect(0, 0, size, size);
            child.graphics.endFill();
            addChild(child);
            stage.focus = child;
            child.addEventListener(KeyboardEvent.KEY_DOWN, keyDownHandler);
            child.addEventListener(KeyboardEvent.KEY_UP, keyUpHandler);
        }

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




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/events/KeyboardEvent.html