| Paquete | flash.events |
| Clase | public class FocusEvent |
| Herencia | FocusEvent Event Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
FocusEvent.FOCUS_INFocusEvent.FOCUS_OUTFocusEvent.KEY_FOCUS_CHANGEFocusEvent.MOUSE_FOCUS_CHANGE| Propiedad | Definido por | ||
|---|---|---|---|
![]() | bubbles : Boolean
[read-only]
Indica si un evento es un evento de propagación.
| Event | |
![]() | cancelable : Boolean
[read-only]
Indica si se puede evitar el comportamiento asociado al evento.
| Event | |
![]() | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
| Object | |
![]() | currentTarget : Object
[read-only]
El objeto que procesa de forma activa el objeto de evento con un detector de eventos.
| Event | |
![]() | eventPhase : 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 | ||
![]() | prototype : 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 | ||
![]() | target : Object
[read-only]
El destino del evento.
| Event | |
![]() | type : String
[read-only]
El tipo de evento.
| Event | |
| Método | Definido 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 | ||
![]() |
Una función de utilidad para implementar el método toString() en la clase Event personalizada.
| 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 una cadena con todas las propiedades del objeto FocusEvent.
| FocusEvent | ||
![]() |
Devuelve el valor simple del objeto especificado.
| Object | |
| Constante | Definido por | ||
|---|---|---|---|
![]() | ACTIVATE : String = "activate" [static]
Define el valor de la propiedad type para un objeto de evento activate.
| Event | |
![]() | ADDED : String = "added" [static]
Define el valor de la propiedad type para un objeto de evento added.
| Event | |
![]() | ADDED_TO_STAGE : String = "addedToStage" [static]
Define el valor de la propiedad type para un objeto de evento addedToStage.
| Event | |
![]() | CANCEL : String = "cancel" [static]
Define el valor de la propiedad type para un objeto de evento cancel.
| Event | |
![]() | CHANGE : String = "change" [static]
Define el valor de la propiedad type para un objeto de evento change.
| Event | |
![]() | CLOSE : String = "close" [static]
Define el valor de la propiedad type para un objeto de evento close.
| Event | |
![]() | COMPLETE : String = "complete" [static]
Define el valor de la propiedad type para un objeto de evento complete.
| Event | |
![]() | CONNECT : String = "connect" [static]
Define el valor de la propiedad type para un objeto de evento connect.
| Event | |
![]() | DEACTIVATE : String = "deactivate" [static]
Define el valor de la propiedad type para un objeto de evento deactivate.
| Event | |
![]() | ENTER_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 | ||
![]() | FULLSCREEN : String = "fullScreen" [static]
Define el valor de la propiedad type para un objeto de evento fullScreen.
| Event | |
![]() | ID3 : String = "id3" [static]
Define el valor de la propiedad type para un objeto de evento id3.
| Event | |
![]() | INIT : 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 | ||
![]() | MOUSE_LEAVE : String = "mouseLeave" [static]
Define el valor de la propiedad type para un objeto de evento mouseLeave.
| Event | |
![]() | OPEN : String = "open" [static]
Define el valor de la propiedad type para un objeto de evento open.
| Event | |
![]() | REMOVED : String = "removed" [static]
Define el valor de la propiedad type para un objeto de evento removed.
| Event | |
![]() | REMOVED_FROM_STAGE : String = "removedFromStage" [static]
Define el valor de la propiedad type para un objeto de evento removedFromStage.
| Event | |
![]() | RENDER : String = "render" [static]
Define el valor de la propiedad type para un objeto de evento render.
| Event | |
![]() | RESIZE : String = "resize" [static]
Define el valor de la propiedad type para un objeto de evento resize.
| Event | |
![]() | SCROLL : String = "scroll" [static]
Define el valor de la propiedad type para un objeto de evento scroll.
| Event | |
![]() | SELECT : String = "select" [static]
Define el valor de la propiedad type para un objeto de evento select.
| Event | |
![]() | SOUND_COMPLETE : String = "soundComplete" [static]
Define el valor de la propiedad type para un objeto de evento soundComplete.
| Event | |
![]() | TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [static]
Define el valor de la propiedad type para un objeto de evento tabChildrenChange.
| Event | |
![]() | TAB_ENABLED_CHANGE : String = "tabEnabledChange" [static]
Define el valor de la propiedad type para un objeto de evento tabEnabledChange.
| Event | |
![]() | TAB_INDEX_CHANGE : String = "tabIndexChange" [static]
Define el valor de la propiedad type para un objeto de evento tabIndexChange.
| Event | |
![]() | UNLOAD : String = "unload" [static]
Define el valor de la propiedad type para un objeto de evento unload.
| Event | |
| keyCode | propiedad |
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.
public function get keyCode():uint
public function set keyCode(value:uint):void
| relatedObject | propiedad |
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.
public function get relatedObject():InteractiveObject
public function set relatedObject(value:InteractiveObject):void
| shiftKey | propiedad |
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.
public function get shiftKey():Boolean
public function set shiftKey(value:Boolean):void
| 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ámetrostype: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
| 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 devueltoEvent — 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]
String — Una cadena que contiene todas las propiedades del objeto FocusEvent.
|
| FOCUS_IN | Constante |
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:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | 0; se aplica sólo a eventos keyFocusChange. |
relatedObject | La instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección. |
shiftKey | false; se aplica sólo a eventos keyFocusChange. |
target | La 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_OUT | Constante |
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:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | 0; se aplica sólo a eventos keyFocusChange. |
relatedObject | La instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección. |
shiftKey | false; se aplica sólo a eventos keyFocusChange. |
target | La 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_CHANGE | Constante |
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:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | true; llama al método preventDefault() para cancelar el comportamiento predeterminado. |
currentTarget | El objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | El valor de código de la tecla presionada para desencadenar un evento keyFocusChange. |
relatedObject | La instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección. |
shiftKey | true si el modificador de la tecla Mayús está activado; de lo contrario, es false. |
target | La 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_CHANGE | Constante |
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:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | true; llama al método preventDefault() para cancelar el comportamiento predeterminado. |
currentTarget | El objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | 0; se aplica sólo a eventos keyFocusChange. |
relatedObject | La instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección. |
shiftKey | false; se aplica sólo a eventos keyFocusChange. |
target | La 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
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:
child (de tipo Sprite) y childCount (de tipo uint).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:
size de tipo uint se define en 50 píxeles y bgColor se establece en color azul claro. buttonMode y useHandCursor de la clase Sprite se definen como true en el constructor.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.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.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.for, cada cuadrado se añade a la lista de visualización y se muestra (en la misma área) por medio de addChild().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