ComponentEvent

Pacchetto	fl.events
Classe	public class ComponentEvent
Ereditarietà	ComponentEvent Event Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

La classe ComponentEvent definisce gli eventi associati alla classe UIComponent. Tali eventi includono i seguenti:

ComponentEvent.BUTTON_DOWN: inviato quando viene premuto un pulsante.
ComponentEvent.ENTER: inviato quando viene premuto il tasto Invio.
ComponentEvent.HIDE: inviato quando la proprietà visible di un componente viene impostata su false.
ComponentEvent.LABEL_CHANGE: inviato quando viene premuto il tasto Invio.
ComponentEvent.MOVE: inviato quando si verifica una modifica delle proprietà x o y che identificano la posizione del componente.
ComponentEvent.RESIZE: inviato quando un componente viene ridimensionato.
ComponentEvent.SHOW: inviato quando la proprietà visible di un componente viene impostata su false.

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		bubbles : Boolean [sola lettura] Indica se un evento è un evento di bubbling.	Event
		cancelable : Boolean [sola lettura] Indica se il comportamento associato all'evento può essere impedito.	Event
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		currentTarget : Object [sola lettura] L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.	Event
		eventPhase : uint [sola lettura] La fase attuale del flusso di eventi.	Event
		target : Object [sola lettura] Il target dell'evento.	Event
		type : String [sola lettura] Il tipo di evento.	Event

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		ComponentEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false) Crea un nuovo oggetto ComponentEvent contenente informazioni relative a un evento di un componente.	ComponentEvent
		clone():Event [override] Crea una copia dell'oggetto ComponentEvent e imposta il valore di ogni parametro in modo che corrisponda all'originale.	ComponentEvent
		formatToString(className:String, ... arguments):String Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate.	Event
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isDefaultPrevented():Boolean Verifica se sull'evento è stato chiamato il metodo preventDefault().	Event
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		preventDefault():void Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato.	Event
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		stopImmediatePropagation():void Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi.	Event
		stopPropagation():void Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente.	Event
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String [override] Restituisce una stringa che contiene tutte le proprietà dell'oggetto ComponentEvent.	ComponentEvent
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

Costanti pubbliche

Nascondi costanti pubbliche ereditate

Mostra costanti pubbliche ereditate

	Costante		Definito da
		BUTTON_DOWN : String = "buttonDown" [statico] Definisce il valore della proprietà type di un oggetto evento buttonDown.	ComponentEvent
		ENTER : String = "enter" [statico] Definisce il valore della proprietà type di un oggetto evento enter.	ComponentEvent
		HIDE : String = "hide" [statico] Definisce il valore della proprietà type di un oggetto evento hide.	ComponentEvent
		LABEL_CHANGE : String = "labelChange" [statico] Definisce il valore della proprietà type di un oggetto evento labelChange.	ComponentEvent
		MOVE : String = "move" [statico] Definisce il valore della proprietà type di un oggetto evento move.	ComponentEvent
		RESIZE : String = "resize" [statico] Definisce il valore della proprietà type di un oggetto evento resize.	ComponentEvent
		SHOW : String = "show" [statico] Definisce il valore della proprietà type di un oggetto evento show.	ComponentEvent

Descrizione della funzione di costruzione

()

Funzione di costruzione

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

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Crea un nuovo oggetto ComponentEvent contenente informazioni relative a un evento di un componente. Un oggetto ComponentEvent viene passato a un listener di eventi come parametro.

Parametri

	`type:String` — Il tipo di evento. I listener di eventi possono accedere a queste informazioni tramite la proprietà `type` dell'oggetto evento. Un componente può avere i seguenti tipi di eventi: `ComponentEvent.BUTTON_DOWN`, `ComponentEvent.ENTER`, `ComponentEvent.HIDE`, `ComponentEvent.LABEL_CHANGE`, `ComponentEvent.MOVE`, `ComponentEvent.RESIZE`, `ComponentEvent.SHOW`.

	`bubbles:Boolean` (default = `false`) — Determina se l'oggetto ComponentEvent partecipa alla fase di bubbling del flusso di eventi. I listener di eventi possono accedere a queste informazioni tramite la proprietà `bubbles` dell'oggetto evento.

	`cancelable:Boolean` (default = `false`) — Determina se l'oggetto ComponentEvent può essere annullato. I listener di eventi possono accedere a queste informazioni tramite la proprietà `cancelable` dell'oggetto evento.

Descrizione dei metodi

clone

()

metodo

override public function clone():Event

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Crea una copia dell'oggetto ComponentEvent e imposta il valore di ogni parametro in modo che corrisponda all'originale.

Restituisce

Event — Un nuovo oggetto ComponentEvent con proprietà dai valori identici a quelli dell'originale.

toString

()

metodo

override public function toString():String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Restituisce una stringa che contiene tutte le proprietà dell'oggetto ComponentEvent. La stringa ha il seguente formato:

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

Restituisce

String — La rappresentazione in formato stringa dell'oggetto ComponentEvent.

Descrizione delle costanti

BUTTON_DOWN

Costante

public static const BUTTON_DOWN:String = "buttonDown"

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Definisce il valore della proprietà type di un oggetto evento buttonDown.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto event con un listener di eventi.
`target`	L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà `currentTarget` per accedere all'oggetto che intercetta l'evento.

ENTER

Costante

public static const ENTER:String = "enter"

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Definisce il valore della proprietà type di un oggetto evento enter.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto event con un listener di eventi.
`target`	L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà `currentTarget` per accedere all'oggetto che intercetta l'evento.

HIDE

Costante

public static const HIDE:String = "hide"

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Definisce il valore della proprietà type di un oggetto evento hide.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto event con un listener di eventi.
`target`	L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà `currentTarget` per accedere all'oggetto che intercetta l'evento.

Elementi API correlati

SHOW

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un componente Button che attiva la visibilità di 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

Costante

public static const LABEL_CHANGE:String = "labelChange"

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Definisce il valore della proprietà type di un oggetto evento labelChange.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto event con un listener di eventi.
`target`	L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà `currentTarget` per accedere all'oggetto che intercetta l'evento.

MOVE

Costante

public static const MOVE:String = "move"

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Definisce il valore della proprietà type di un oggetto evento move.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto event con un listener di eventi.
`target`	L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà `currentTarget` per accedere all'oggetto che intercetta l'evento.

Esempio ( Come utilizzare questo esempio )

L'esempio seguente riposiziona un'istanza del componente UILoader sullo stage in base al valore di 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

Costante

public static const RESIZE:String = "resize"

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Definisce il valore della proprietà type di un oggetto evento resize.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto event con un listener di eventi.
`target`	L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà `currentTarget` per accedere all'oggetto che intercetta l'evento.

Esempio ( Come utilizzare questo esempio )

L'esempio seguente carica un'immagine esterna in un'istanza del componente UILoader e la centra sullo stage utilizzando l'evento resize e il metodo 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

Costante

public static const SHOW:String = "show"

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flash CS3

Versioni runtime:

Flash Player 9.0.28.0, AIR 1.0

Definisce il valore della proprietà type di un oggetto evento show.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto event con un listener di eventi.
`target`	L'oggetto che invia l'evento. Il target non è sempre l'oggetto listener dell'evento. Utilizzate la proprietà `currentTarget` per accedere all'oggetto che intercetta l'evento.

Elementi API correlati

HIDE

Esempio ( Come utilizzare questo esempio )

L'esempio seguente crea un componente Button che attiva la visibilità di 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);
}

Note legali | Informativa sulla privacy online

ComponentEvent - AS3 Flash

Classi x

ComponentEvent

clone

toString

BUTTON_DOWN

ENTER

HIDE

LABEL_CHANGE

MOVE

RESIZE

SHOW