Paquetefl.events
Clasepublic class ComponentEvent
HerenciaComponentEvent Inheritance Event Inheritance Object

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

La clase ComponentEvent define eventos asociados a la clase UIComponent. Entre estos eventos se incluyen los siguientes:



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
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
 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
  
ComponentEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false)
Crea un nuevo objeto ComponentEvent que contiene información sobre un evento de componente.
ComponentEvent
  
Crea una copia del objeto ComponentEvent y define el valor de cada parámetro para que coincida con el original.
ComponentEvent
 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 ComponentEvent.
ComponentEvent
 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
  BUTTON_DOWN : String = "buttonDown"
[static] Define el valor de la propiedad type para un objeto de evento buttonDown.
ComponentEvent
 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
  ENTER : String = "enter"
[static] Define el valor de la propiedad type para un objeto de evento enter.
ComponentEvent
 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
  HIDE : String = "hide"
[static] Define el valor de la propiedad type para un objeto de evento hide.
ComponentEvent
 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
  LABEL_CHANGE : String = "labelChange"
[static] Define el valor de la propiedad type para un objeto de evento labelChange.
ComponentEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Define el valor de la propiedad type para un objeto de evento mouseLeave.
Event
  MOVE : String = "move"
[static] Define el valor de la propiedad type para un objeto de evento move.
ComponentEvent
 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
  RESIZE : String = "resize"
[static] Define el valor de la propiedad type para un objeto de evento resize.
ComponentEvent
 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
  SHOW : String = "show"
[static] Define el valor de la propiedad type para un objeto de evento show.
ComponentEvent
 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 constructores
ComponentEvent()constructor
public function ComponentEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false)

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

Crea un nuevo objeto ComponentEvent que contiene información sobre un evento de componente. Un objeto ComponentEvent se transfiere como un parámetro a un detector de eventos.

Parámetros
type:String — El tipo de evento. Los detectores de eventos pueden acceder a esta información a través de la propiedad type del objeto de evento. Un componente puede tener los siguientes tipos de eventos: ComponentEvent.BUTTON_DOWN, ComponentEvent.ENTER, ComponentEvent.HIDE, ComponentEvent.LABEL_CHANGE, ComponentEvent.MOVE, ComponentEvent.RESIZE, ComponentEvent.SHOW.
 
bubbles:Boolean (default = false) — Determina si el objeto ComponentEvent participa en la fase de propagación del flujo del evento. Los detectores de eventos pueden acceder a esta información a través de la propiedad bubbles del objeto de evento.
 
cancelable:Boolean (default = false) — Determina si se puede cancelar el objeto ComponentEvent. Los detectores de eventos pueden acceder a esta información a través de la propiedad cancelable del objeto de evento.
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.0.28.0

Crea una copia del objeto ComponentEvent y define el valor de cada parámetro para que coincida con el original.

Valor devuelto
Event — Un nuevo objeto ComponentEvent 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.0.28.0

Devuelve una cadena con todas las propiedades del objeto ComponentEvent. La cadena tiene el siguiente formato:

[ComponentEvent type=value bubbles=value cancelable=value]

Valor devuelto
String — Una representación de cadena del objeto ComponentEvent.
Información sobre constantes
BUTTON_DOWNConstante
public static const BUTTON_DOWN:String = "buttonDown"

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

Define el valor de la propiedad type para un objeto de evento buttonDown.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.

ENTERConstante 
public static const ENTER:String = "enter"

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

Define el valor de la propiedad type para un objeto de evento enter.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.

HIDEConstante 
public static const HIDE:String = "hide"

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

Define el valor de la propiedad type para un objeto de evento hide.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.

Véase también


Ejemplo

En el ejemplo siguiente, se crea un componente Button que activa la visibilidad de un componente List:

import fl.controls.Button;
import fl.controls.List;
import fl.events.ComponentEvent;
import fl.events.ListEvent;

var toggleButton:Button = new Button();
toggleButton.label = "toggle visibility";
toggleButton.toggle = true;
toggleButton.selected = true;
toggleButton.emphasized = toggleButton.selected;
toggleButton.addEventListener(Event.CHANGE, changeHandler);
toggleButton.width = 150;
toggleButton.move(10, 10);
addChild(toggleButton);

var myList:List = new List();
myList.addItem({label:"Item 1"});
myList.addItem({label:"Item 2"});
myList.addItem({label:"Item 3"});
myList.addItem({label:"Item 4"});
myList.addItem({label:"Item 5"});
myList.move(10, 40);
myList.addEventListener(ComponentEvent.HIDE, hideHandler);
myList.addEventListener(ComponentEvent.SHOW, showHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
addChild(myList);


function changeHandler(event:Event):void {
    toggleButton.emphasized = toggleButton.selected;
    myList.visible = toggleButton.selected;
}

function hideHandler(event:ComponentEvent):void {
    trace("hiding list");
    myList.removeEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
    myList.removeEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
}

function showHandler(event:ComponentEvent):void {
    trace("showing list");
    myList.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
    myList.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
}

function itemRollOverHandler(event:ListEvent):void {
    trace(event.type + ":", event.item.label);
}

function itemRollOutHandler(event:ListEvent):void {
    trace(event.type + ":", event.item.label);
}
LABEL_CHANGEConstante 
public static const LABEL_CHANGE:String = "labelChange"

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

Define el valor de la propiedad type para un objeto de evento labelChange.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.

MOVEConstante 
public static const MOVE:String = "move"

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

Define el valor de la propiedad type para un objeto de evento move.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.


Ejemplo

En el ejemplo siguiente, se cambia de posición una instancia del componente UILoader en el escenario en función del valor de un componente Slider:

import fl.controls.Slider;
import fl.containers.UILoader;
import fl.events.ComponentEvent;
import fl.events.SliderEvent;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.move(10, 20);
myUILoader.addEventListener(ComponentEvent.MOVE, moveHandler);
addChild(myUILoader);

var mySlider:Slider = new Slider();
mySlider.liveDragging = true;
mySlider.minimum = myUILoader.x;
mySlider.maximum = myUILoader.x + 200;
mySlider.snapInterval = 1;
mySlider.tickInterval = 10;
mySlider.move(10, 10);
mySlider.addEventListener(SliderEvent.CHANGE, changeHandler);
addChild(mySlider);

function changeHandler(event:SliderEvent):void {
    myUILoader.x = event.value;
}

function moveHandler(event:ComponentEvent):void {
    trace("[move] x:" + event.currentTarget.x + ", y:" + event.currentTarget.y);
}
RESIZEConstante 
public static const RESIZE:String = "resize"

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

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

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.


Ejemplo

En el ejemplo siguiente, se carga una imagen externa en una instancia del componente UILoader y se centra en el escenario con el evento resize y el método move():

import fl.containers.UILoader;
import fl.events.ComponentEvent;

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.addEventListener(ComponentEvent.RESIZE, resizeHandler);
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
addChild(myUILoader);

function resizeHandler(event:ComponentEvent):void {
    var myImg:UILoader = event.currentTarget as UILoader;
    var newX:uint = (stage.stageWidth - myImg.width) / 2;
    var newY:uint = (stage.stageHeight - myImg.height) / 2;
    myImg.move(newX, newY);
}
SHOWConstante 
public static const SHOW:String = "show"

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

Define el valor de la propiedad type para un objeto de evento show.

Este evento tiene las propiedades siguientes:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetObjeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetError que distribuyó el evento. El destino no es siempre el objeto que detecta el evento. Utilice la propiedad currentTarget para acceder al objeto que detecta el evento.

Véase también


Ejemplo

En el ejemplo siguiente, se crea un componente Button que activa la visibilidad de un componente List:

import fl.controls.Button;
import fl.controls.List;
import fl.events.ComponentEvent;
import fl.events.ListEvent;

var toggleButton:Button = new Button();
toggleButton.label = "toggle visibility";
toggleButton.toggle = true;
toggleButton.selected = true;
toggleButton.emphasized = toggleButton.selected;
toggleButton.addEventListener(Event.CHANGE, changeHandler);
toggleButton.width = 150;
toggleButton.move(10, 10);
addChild(toggleButton);

var myList:List = new List();
myList.addItem({label:"Item 1"});
myList.addItem({label:"Item 2"});
myList.addItem({label:"Item 3"});
myList.addItem({label:"Item 4"});
myList.addItem({label:"Item 5"});
myList.move(10, 40);
myList.addEventListener(ComponentEvent.HIDE, hideHandler);
myList.addEventListener(ComponentEvent.SHOW, showHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
myList.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
addChild(myList);


function changeHandler(event:Event):void {
    toggleButton.emphasized = toggleButton.selected;
    myList.visible = toggleButton.selected;
}

function hideHandler(event:ComponentEvent):void {
    trace("hiding list");
    myList.removeEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
    myList.removeEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
}

function showHandler(event:ComponentEvent):void {
    trace("showing list");
    myList.addEventListener(ListEvent.ITEM_ROLL_OVER, itemRollOverHandler);
    myList.addEventListener(ListEvent.ITEM_ROLL_OUT, itemRollOverHandler);
}

function itemRollOverHandler(event:ListEvent):void {
    trace(event.type + ":", event.item.label);
}

function itemRollOutHandler(event:ListEvent):void {
    trace(event.type + ":", event.item.label);
}




 

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/fl/events/ComponentEvent.html