Paqueteflash.events
Clasepublic class FocusEvent
HerenciaFocusEvent Inheritance Event Inheritance Object

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

Flash® Player distribuye objetos FocusEvent cuando el usuario cambia la selección de un objeto a otro en la lista de visualización. Existen cuatro tipos de eventos de selección:

Ver los ejemplos



Propiedades públicas
 PropiedadDefinido por
 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
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
 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 la tecla presionada para desencadenar un evento keyFocusChange.
FocusEvent
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  relatedObject : InteractiveObject
Referencia a la instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección.
FocusEvent
  shiftKey : Boolean
Indica si se activa el modificador de la tecla Mayús, en cuyo caso el valor es true.
FocusEvent
 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
  
FocusEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, relatedObject:InteractiveObject = null, shiftKey:Boolean = false, keyCode:uint = 0)
Crea un objeto de evento con información específica relacionada con los eventos Focus.
FocusEvent
  
Crea una copia del objeto FocusEvent y define el valor de cada propiedad para que coincida con el del objeto original.
FocusEvent
 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 FocusEvent.
FocusEvent
 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
  FOCUS_IN : String = "focusIn"
[static] Define el valor de la propiedad type para un objeto de evento focusIn.
FocusEvent
  FOCUS_OUT : String = "focusOut"
[static] Define el valor de la propiedad type para un objeto de evento focusOut.
FocusEvent
 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_FOCUS_CHANGE : String = "keyFocusChange"
[static] Define el valor de la propiedad type para un objeto de evento keyFocusChange.
FocusEvent
  MOUSE_FOCUS_CHANGE : String = "mouseFocusChange"
[static] Define el valor de la propiedad type para un objeto de evento mouseFocusChange.
FocusEvent
 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
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 la tecla presionada para desencadenar un evento keyFocusChange.


Implementación
    public function get keyCode():uint
    public function set keyCode(value:uint):void
relatedObjectpropiedad 
relatedObject:InteractiveObject  [read-write]

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

Referencia a la instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección. Por ejemplo, si se produce un evento focusOut, relatedObject representa a la instancia InteractiveObject que pasa a estar seleccionada.


Implementación
    public function get relatedObject():InteractiveObject
    public function set relatedObject(value:InteractiveObject):void
shiftKeypropiedad 
shiftKey:Boolean  [read-write]

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

Indica si se activa el modificador de la tecla Mayús, en cuyo caso el valor es true. De lo contrario, el valor es false. Esta propiedad sólo se utiliza si el evento FocusEvent es de tipo keyFocusChange.


Implementación
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean):void
Información sobre constructores
FocusEvent()constructor
public function FocusEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, relatedObject:InteractiveObject = null, shiftKey:Boolean = false, keyCode:uint = 0)

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

Crea un objeto de evento con información específica relacionada con los eventos Focus. 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: FocusEvent.FOCUS_IN, FocusEvent.FOCUS_OUT, FocusEvent.KEY_FOCUS_CHANGE y FocusEvent.MOUSE_FOCUS_CHANGE.
 
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.
 
relatedObject:InteractiveObject (default = null) — Indica la instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección. Por ejemplo, si se produce un evento focusIn, relatedObject representa al objeto InteractiveObject que ha dejado de estar seleccionado.
 
shiftKey:Boolean (default = false) — Indica si el modificador de la tecla Mayús está activado.
 
keyCode:uint (default = 0) — Indica el código de la tecla presionada para desencadenar un evento keyFocusChange.

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 FocusEvent y define el valor de cada propiedad para que coincida con el del objeto original.

Valor devuelto
Event — Un nuevo objeto FocusEvent 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 FocusEvent. La cadena tiene el siguiente formato:

[FocusEvent type=value bubbles=value cancelable=value relatedObject=value shiftKey=value]

Valor devuelto
String — Una cadena que contiene todas las propiedades del objeto FocusEvent.
Información sobre constantes
FOCUS_INConstante
public static const FOCUS_IN:String = "focusIn"

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

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblestrue
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
keyCode0; se aplica sólo a eventos keyFocusChange.
relatedObjectLa instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección.
shiftKeyfalse; se aplica sólo a eventos keyFocusChange.
targetLa instancia InteractiveObject que acaba de seleccionarse. 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

FOCUS_OUTConstante 
public static const FOCUS_OUT:String = "focusOut"

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

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblestrue
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
keyCode0; se aplica sólo a eventos keyFocusChange.
relatedObjectLa instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección.
shiftKeyfalse; se aplica sólo a eventos keyFocusChange.
targetLa instancia InteractiveObject que acaba de perder la selección. 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_FOCUS_CHANGEConstante 
public static const KEY_FOCUS_CHANGE:String = "keyFocusChange"

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

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblestrue
cancelabletrue; llama al método preventDefault() para cancelar el comportamiento predeterminado.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
keyCodeEl valor de código de la tecla presionada para desencadenar un evento keyFocusChange.
relatedObjectLa instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección.
shiftKeytrue si el modificador de la tecla Mayús está activado; de lo contrario, es false.
targetLa instancia InteractiveObject que está seleccionada actualmente. 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

MOUSE_FOCUS_CHANGEConstante 
public static const MOUSE_FOCUS_CHANGE:String = "mouseFocusChange"

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

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblestrue
cancelabletrue; llama al método preventDefault() para cancelar el comportamiento predeterminado.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
keyCode0; se aplica sólo a eventos keyFocusChange.
relatedObjectLa instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección.
shiftKeyfalse; se aplica sólo a eventos keyFocusChange.
targetLa instancia InteractiveObject que está seleccionada actualmente. 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
FocusEventExample.as

En el ejemplo siguiente, se utilizan las clases FocusEventExample y CustomSprite para mostrar cómo se puede utilizar la selección en combinación con los elementos dibujados en el escenario para capturar eventos e imprimir información. El ejemplo realiza las siguientes tareas:
  1. Declara las propiedades child (de tipo Sprite) y childCount (de tipo uint).
  2. Un bucle for crea cinco cuadrados de color azul claro en (0,0). Comienza asignando child a una nueva instancia de CustomSprite. Cada vez que se crea un objeto CustomSprite, ocurre lo siguiente:
    • La propiedad size de tipo uint se define en 50 píxeles y bgColor se establece en color azul claro.
    • Las propiedades buttonMode y useHandCursor de la clase Sprite se definen como true en el constructor.
    • Se crea una instancia de un detector de eventos de tipo click, junto con el suscriptor asociado clickHandler(). El método suscriptor crea una variable local target de tipo Sprite y le asigna cualquiera de los cuadros en los que se haya hecho clic. La selección del escenario se asigna a target.
    • Se llama al método draw(), que crea un cuadrado de 50 x 50 píxeles llamando a los métodos beginFill(), drawRect() y endFill() de la clase Graphics y a las propiedades de la instancia.
  3. En el bucle for, se llama al método configureListeners(), que crea instancias de tres detectores/suscriptores de eventos:
    • focusIn/focusInHandler() se distribuye después del evento click para cualquier objeto de lista (cuadro) en el que se haga clic.
    • focusOut/focusOutHandler() se distribuye cuando se hace clic en otro cuadro o si la selección deja de estar en el escenario (por ejemplo, haciendo clic fuera de Flash Player).
    • keyFocusChange/keyFocusChangeHandler() se distribuye si se utiliza el tabulador o las teclas de flecha izquierda y derecha para seleccionar un objeto de la lista de visualización. Sin embargo, el método keyFocusChangeHandler() atrapa las teclas de flecha izquierda y flecha derecha y llama al método preventDefault() para desactivarlas.
  4. En el bucle for, cada cuadrado se añade a la lista de visualización y se muestra (en la misma área) por medio de addChild().
  5. El constructor llama a refreshLayout(), que distribuye los cuadrados naranjas en la parte superior (y = 0) de la pantalla con 5 píxeles de separación entre cada cuadrado.
package {
    import flash.display.Sprite;
    import flash.display.DisplayObject;
    import flash.events.FocusEvent;
    import flash.events.IEventDispatcher;

    public class FocusEventExample extends Sprite {
        private var gutter:uint = 5;
        private var childCount:uint = 5;

        public function FocusEventExample() {
            var child:Sprite;
            for(var i:uint; i < childCount; i++) {
                child = new CustomSprite();
                configureListeners(child);
                addChild(child);
            }
            refreshLayout();
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(FocusEvent.FOCUS_IN, focusInHandler);
            dispatcher.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler);
            dispatcher.addEventListener(FocusEvent.KEY_FOCUS_CHANGE, keyFocusChangeHandler);
            dispatcher.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, mouseFocusChangeHandler);
        }

        private function refreshLayout():void {
            var ln:uint = numChildren;
            var child:DisplayObject = getChildAt(0);
            var lastChild:DisplayObject = child;
            for(var i:uint = 1; i < ln; i++) {
                child = getChildAt(i);
                child.x = lastChild.x + lastChild.width + gutter;
                lastChild = child;
            }
        }

        private function focusInHandler(event:FocusEvent):void {
            var target:CustomSprite = CustomSprite(event.target);
            trace("focusInHandler: " + target.name);
        }

        private function focusOutHandler(event:FocusEvent):void {
            var target:CustomSprite = CustomSprite(event.target);
            trace("focusOutHandler: " + target.name);
        }

        private function keyFocusChangeHandler(event:FocusEvent):void {
            if(event.keyCode == 39 || event.keyCode == 37){
                event.preventDefault()
            }
            var target:CustomSprite = CustomSprite(event.target);
            trace("keyFocusChangeHandler: " + target.name);
        }
        private function mouseFocusChangeHandler(event:FocusEvent):void {
            var target:CustomSprite = CustomSprite(event.target);
            trace("mouseFocusChangeHandler: " + target.name);
        }
    }
}

import flash.display.Sprite;
import flash.events.MouseEvent;

class CustomSprite extends Sprite {
    private var size:uint = 50;
    private var bgColor:uint = 0x00CCFF;

    public function CustomSprite() {
        buttonMode = true;
        useHandCursor = true;
        addEventListener(MouseEvent.CLICK, clickHandler);
        draw(size, size);
    }

    private function draw(w:uint, h:uint):void {
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, w, h);
        graphics.endFill();
    }

    private function clickHandler(event:MouseEvent):void {
        var target:Sprite = Sprite(event.target);
        trace("clickHandler: " + target.name);
        stage.focus = target;
    }
}




 

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/FocusEvent.html