ComponentEvent

Paquete	fl.events
Clase	public class ComponentEvent
Herencia	ComponentEvent Event Object

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

ComponentEvent.BUTTON_DOWN: se distribuye cuando se presiona un botón.
ComponentEvent.ENTER: se distribuye cuando se presiona la tecla Intro.
ComponentEvent.HIDE: se distribuye cuando la propiedad visible de un componente se establece como false.
ComponentEvent.LABEL_CHANGE: se distribuye cuando se presiona la tecla Intro.
ComponentEvent.MOVE: se distribuye cuando se realiza un cambio en las propiedades x o y que identifican la ubicación del componente.
ComponentEvent.RESIZE: se distribuye cuando se cambia el tamaño de un componente.
ComponentEvent.SHOW: se distribuye cuando la propiedad visible de un componente se establece como true.

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		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
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		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
		target : Object [solo lectura] El destino del evento.	Event
		type : String [solo lectura] El tipo de evento.	Event

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido 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
		clone():Event [override] Crea una copia del objeto ComponentEvent y define el valor de cada parámetro para que coincida con el original.	ComponentEvent
		formatToString(className:String, ... arguments):String Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0.	Event
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isDefaultPrevented():Boolean Comprueba si se ha llamado a preventDefault() en el evento.	Event
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		preventDefault():void Cancela el comportamiento predeterminado de un evento si es posible cancelarlo.	Event
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		stopImmediatePropagation():void Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento.	Event
		stopPropagation():void Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual.	Event
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String [override] Devuelve una cadena con todas las propiedades del objeto ComponentEvent.	ComponentEvent
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object

Constantes públicas

Ocultar constantes públicas heredadas

Mostrar constantes públicas heredadas

	Constante		Definido por
		BUTTON_DOWN : String = "buttonDown" [estática] Define el valor de la propiedad type para un objeto de evento buttonDown.	ComponentEvent
		ENTER : String = "enter" [estática] Define el valor de la propiedad type para un objeto de evento enter.	ComponentEvent
		HIDE : String = "hide" [estática] Define el valor de la propiedad type para un objeto de evento hide.	ComponentEvent
		LABEL_CHANGE : String = "labelChange" [estática] Define el valor de la propiedad type para un objeto de evento labelChange.	ComponentEvent
		MOVE : String = "move" [estática] Define el valor de la propiedad type para un objeto de evento move.	ComponentEvent
		RESIZE : String = "resize" [estática] Define el valor de la propiedad type para un objeto de evento resize.	ComponentEvent
		SHOW : String = "show" [estática] Define el valor de la propiedad type para un objeto de evento show.	ComponentEvent

Información sobre constructores

()

Información sobre

public function ComponentEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false)

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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

override public function clone():Event

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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

override public function toString():String

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.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_DOWN

Constante

public static const BUTTON_DOWN:String = "buttonDown"

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Error 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.

ENTER

Constante

public static const ENTER:String = "enter"

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Error 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.

HIDE

Constante

public static const HIDE:String = "hide"

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Error 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.

Elementos de API relacionados

SHOW

Ejemplo ( Cómo utilizar este 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_CHANGE

Constante

public static const LABEL_CHANGE:String = "labelChange"

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Error 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.

MOVE

Constante

public static const MOVE:String = "move"

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Error 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 ( Cómo utilizar este 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);
}

RESIZE

Constante

public static const RESIZE:String = "resize"

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Error 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 ( Cómo utilizar este 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);
}

SHOW

Constante

public static const SHOW:String = "show"

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flash CS3

Versiones de motor de ejecución:

Flash Player 9.0.28.0, AIR 1.0

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

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	Error 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.

Elementos de API relacionados

HIDE

Ejemplo ( Cómo utilizar este 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);
}

Avisos legales | Política de privacidad en línea

ComponentEvent - AS3 Flash

Clases x

ComponentEvent

clone

toString

BUTTON_DOWN

ENTER

HIDE

LABEL_CHANGE

MOVE

RESIZE

SHOW