fl.events.ComponentEvent (ActionScript 3.0)

	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
		prototype: Object [statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.	Object
		target: Object [sola lettura] Il target dell'evento.	Event
		type: String [sola lettura] Il tipo di evento.	Event

	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 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 di utilità per l'implementazione del metodo toString() nella classe Event personalizzata.	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
		toString():String Restituisce una stringa che contiene tutte le proprietà dell'oggetto ComponentEvent.	ComponentEvent
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

	Costante	Definito da
		ACTIVATE: String = "activate" [statico] Definisce il valore della proprietà type di un oggetto evento activate.	Event
		ADDED: String = "added" [statico] Definisce il valore della proprietà type di un oggetto evento added.	Event
		ADDED_TO_STAGE: String = "addedToStage" [statico] Definisce il valore della proprietà type di un oggetto evento addedToStage.	Event
		BUTTON_DOWN: String = "buttonDown" [statico] Definisce il valore della proprietà type di un oggetto evento buttonDown.	ComponentEvent
		CANCEL: String = "cancel" [statico] Definisce il valore della proprietà type di un oggetto evento cancel.	Event
		CHANGE: String = "change" [statico] Definisce il valore della proprietà type di un oggetto evento change.	Event
		CLOSE: String = "close" [statico] Definisce il valore della proprietà type di un oggetto evento close.	Event
		COMPLETE: String = "complete" [statico] Definisce il valore della proprietà type di un oggetto evento complete.	Event
		CONNECT: String = "connect" [statico] Definisce il valore della proprietà type di un oggetto evento connect.	Event
		DEACTIVATE: String = "deactivate" [statico] Definisce il valore della proprietà type di un oggetto evento deactivate.	Event
		ENTER: String = "enter" [statico] Definisce il valore della proprietà type di un oggetto evento enter.	ComponentEvent
		ENTER_FRAME: String = "enterFrame" [statico] Definisce il valore della proprietà type di un oggetto evento enterFrame.	Event
		FULLSCREEN: String = "fullScreen" [statico] Definisce il valore della proprietà type di un oggetto evento fullScreen.	Event
		HIDE: String = "hide" [statico] Definisce il valore della proprietà type di un oggetto evento hide.	ComponentEvent
		ID3: String = "id3" [statico] Definisce il valore della proprietà type di un oggetto evento id3.	Event
		INIT: String = "init" [statico] Definisce il valore della proprietà type di un oggetto evento init.	Event
		LABEL_CHANGE: String = "labelChange" [statico] Definisce il valore della proprietà type di un oggetto evento labelChange.	ComponentEvent
		MOUSE_LEAVE: String = "mouseLeave" [statico] Definisce il valore della proprietà type di un oggetto evento mouseLeave.	Event
		MOVE: String = "move" [statico] Definisce il valore della proprietà type di un oggetto evento move.	ComponentEvent
		OPEN: String = "open" [statico] Definisce il valore della proprietà type di un oggetto evento open.	Event
		REMOVED: String = "removed" [statico] Definisce il valore della proprietà type di un oggetto evento removed.	Event
		REMOVED_FROM_STAGE: String = "removedFromStage" [statico] Definisce il valore della proprietà type di un oggetto evento removedFromStage.	Event
		RENDER: String = "render" [statico] Definisce il valore della proprietà type di un oggetto evento render.	Event
		RESIZE: String = "resize" [statico] Definisce il valore della proprietà type di un oggetto evento resize.	ComponentEvent
		SCROLL: String = "scroll" [statico] Definisce il valore della proprietà type di un oggetto evento scroll.	Event
		SELECT: String = "select" [statico] Definisce il valore della proprietà type di un oggetto evento select.	Event
		SHOW: String = "show" [statico] Definisce il valore della proprietà type di un oggetto evento show.	ComponentEvent
		SOUND_COMPLETE: String = "soundComplete" [statico] Definisce il valore della proprietà type di un oggetto evento soundComplete.	Event
		TAB_CHILDREN_CHANGE: String = "tabChildrenChange" [statico] Definisce il valore della proprietà type di un oggetto evento tabChildrenChange.	Event
		TAB_ENABLED_CHANGE: String = "tabEnabledChange" [statico] Definisce il valore della proprietà type di un oggetto evento tabEnabledChange.	Event
		TAB_INDEX_CHANGE: String = "tabIndexChange" [statico] Definisce il valore della proprietà type di un oggetto evento tabIndexChange.	Event
		UNLOAD: String = "unload" [statico] Definisce il valore della proprietà type di un oggetto evento unload.	Event

Descrizione della funzione di costruzione

ComponentEvent

()

Funzione di costruzione

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

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.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

public override function clone():Event

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.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

public override function toString():String

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.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 lettore:

Flash Player 9.0.28.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. Utilizzare la proprietà `currentTarget` per accedere all'oggetto che ascolta l'evento.

ENTER

Costante

public static const ENTER:String = "enter"

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.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. Utilizzare la proprietà `currentTarget` per accedere all'oggetto che ascolta l'evento.

HIDE

Costante

public static const HIDE:String = "hide"

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.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. Utilizzare la proprietà `currentTarget` per accedere all'oggetto che ascolta l'evento.

Vedere anche

SHOW

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 lettore:

Flash Player 9.0.28.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. Utilizzare la proprietà `currentTarget` per accedere all'oggetto che ascolta l'evento.

MOVE

Costante

public static const MOVE:String = "move"

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9.0.28.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. Utilizzare la proprietà `currentTarget` per accedere all'oggetto che ascolta l'evento.

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 lettore:

Flash Player 9.0.28.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. Utilizzare la proprietà `currentTarget` per accedere all'oggetto che ascolta l'evento.

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 lettore:

Flash Player 9.0.28.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. Utilizzare la proprietà `currentTarget` per accedere all'oggetto che ascolta l'evento.

Vedere anche

HIDE

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);
}

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/fl/events/ComponentEvent.html

Guida di riferimento del linguaggio e dei componenti ActionScript 3.0		Tutti i pacchetti \| Tutte le classi \| Elementi del linguaggio \| Indice \| Appendici \| Convenzioni \| Con frame Senza frame
ComponentEvent	Proprietà \| Metodi \| Costanti

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