fl.events.ComponentEvent (ActionScript 3.0)

	Propriété	Défini par
		bubbles : Boolean [lecture-seule] Indique si un événement peut se propager vers le haut (bubbling).	Event
		cancelable : Boolean [lecture-seule] Indique si le comportement associé à l’événement peut être annulé.	Event
		constructor : Object Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.	Object
		currentTarget : Object [lecture-seule] L’objet qui traite activement l’objet Event avec un écouteur d’événements.	Event
		eventPhase : uint [lecture-seule] Phase actuelle du flux d’événements.	Event
		prototype : Object [static] Référence à l’objet prototype d’un objet de classe ou fonction.	Object
		target : Object [lecture-seule] Cible de l’événement.	Event
		type : String [lecture-seule] Type d’événement.	Event

	Méthode	Défini par
		ComponentEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false) Crée un nouvel objet ComponentEvent qui contient des informations sur un événement de composant.	ComponentEvent
		clone():Event Crée une copie de l'objet ComponentEvent et définit la valeur de chaque paramètre pour correspondre à l'original.	ComponentEvent
		formatToString(className:String, ... arguments):String Fonction d’un utilitaire permettant d'implémenter la méthode toString() dans votre classe Event personnalisée.	Event
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d'un objet est définie.	Object
		isDefaultPrevented():Boolean Vérifie si preventDefault() a été appelée pour l’événement.	Event
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.	Object
		preventDefault():void Annule le comportement par défaut d’un événement si cette opération est possible.	Event
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.	Object
		stopImmediatePropagation():void Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d'événements.	Event
		stopPropagation():void Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements.	Event
		toString():String Renvoie une chaîne répertoriant toutes les propriétés de l'objet ComponentEvent.	ComponentEvent
		valueOf():Object Renvoie la valeur primitive de l'objet spécifié.	Object

	Constante	Défini par
		ACTIVATE : String = "activate" [static] Définit la valeur de la propriété type d'un objet événement activate.	Event
		ADDED : String = "added" [static] Définit la valeur de la propriété type d'un objet événement added.	Event
		ADDED_TO_STAGE : String = "addedToStage" [static] Définit la valeur de la propriété type d'un objet événement addedToStage.	Event
		BUTTON_DOWN : String = "buttonDown" [static] Définit la valeur de la propriété type d'un objet de l'événement buttonDown.	ComponentEvent
		CANCEL : String = "cancel" [static] Définit la valeur de la propriété type d'un objet événement cancel.	Event
		CHANGE : String = "change" [static] Définit la valeur de la propriété type d'un objet événement change.	Event
		CLOSE : String = "close" [static] Définit la valeur de la propriété type d'un objet événement close.	Event
		COMPLETE : String = "complete" [static] Définit la valeur de la propriété type d'un objet événement complete.	Event
		CONNECT : String = "connect" [static] Définit la valeur de la propriété type d'un objet événement connect.	Event
		DEACTIVATE : String = "deactivate" [static] Définit la valeur de la propriété type d'un objet événement deactivate.	Event
		ENTER : String = "enter" [static] Définit la valeur de la propriété type d'un objet de l'événement enter.	ComponentEvent
		ENTER_FRAME : String = "enterFrame" [static] Définit la valeur de la propriété type d'un objet événement enterFrame.	Event
		FULLSCREEN : String = "fullScreen" [static] Définit la valeur de la propriété type d'un objet événement fullScreen.	Event
		HIDE : String = "hide" [static] Définit la valeur de la propriété type d'un objet de l'événement hide.	ComponentEvent
		ID3 : String = "id3" [static] Définit la valeur de la propriété type d'un objet événement id3.	Event
		INIT : String = "init" [static] Définit la valeur de la propriété type d'un objet événement init.	Event
		LABEL_CHANGE : String = "labelChange" [static] Définit la valeur de la propriété type d'un objet de l'événement labelChange.	ComponentEvent
		MOUSE_LEAVE : String = "mouseLeave" [static] Définit la valeur de la propriété type d'un objet événement mouseLeave.	Event
		MOVE : String = "move" [static] Définit la valeur de la propriété type d’un objet de l'événement move.	ComponentEvent
		OPEN : String = "open" [static] Définit la valeur de la propriété type d'un objet événement open.	Event
		REMOVED : String = "removed" [static] Définit la valeur de la propriété type d'un objet événement removed.	Event
		REMOVED_FROM_STAGE : String = "removedFromStage" [static] Définit la valeur de la propriété type d'un objet événement removedFromStage.	Event
		RENDER : String = "render" [static] Définit la valeur de la propriété type d'un objet événement render.	Event
		RESIZE : String = "resize" [static] Définit la valeur de la propriété type d'un objet événement resize.	ComponentEvent
		SCROLL : String = "scroll" [static] Définit la valeur de la propriété type d'un objet événement scroll.	Event
		SELECT : String = "select" [static] Définit la valeur de la propriété type d'un objet événement select.	Event
		SHOW : String = "show" [static] Définit la valeur de la propriété type d'un objet de l'événement show.	ComponentEvent
		SOUND_COMPLETE : String = "soundComplete" [static] Définit la valeur de la propriété type d'un objet événement soundComplete.	Event
		TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [static] Définit la valeur de la propriété type d'un objet événement tabChildrenChange.	Event
		TAB_ENABLED_CHANGE : String = "tabEnabledChange" [static] Définit la valeur de la propriété type d'un objet événement tabEnabledChange.	Event
		TAB_INDEX_CHANGE : String = "tabIndexChange" [static] Définit la valeur de la propriété type d'un objet événement tabIndexChange.	Event
		UNLOAD : String = "unload" [static] Définit la valeur de la propriété type d'un objet événement unload.	Event

Détails du constructeur

ComponentEvent

()

Constructeur

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

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9.0.28.0

Crée un nouvel objet ComponentEvent qui contient des informations sur un événement de composant. Un objet ComponentEvent est transmis à un écouteur d'événement sous forme de paramètre.

Paramètres

	`type:String` — Type de l’événement. Les écouteurs d'événements peuvent accéder à ces informations via la propriété `type` de l'objet de l'événement. Tout composant peut avoir les types d'événement suivants : `ComponentEvent.BUTTON_DOWN`, `ComponentEvent.ENTER`, `ComponentEvent.HIDE`, `ComponentEvent.LABEL_CHANGE`, `ComponentEvent.MOVE`, `ComponentEvent.RESIZE`, `ComponentEvent.SHOW`.

	`bubbles:Boolean` (default = `false`) — Détermine si l’objet ComponentEvent prend part à la phase de propagation vers le haut (bubbling) du flux d’événements. Les écouteurs d'événements peuvent accéder à ces informations via la propriété `bubbles` de l'objet de l'événement.

	`cancelable:Boolean` (default = `false`) — Détermine si l’objet ComponentEvent peut être annulé. Les écouteurs d'événements peuvent accéder à ces informations via la propriété `cancelable` de l'objet de l'événement.

Détails des méthodes

clone

()

méthode

public override function clone():Event

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9.0.28.0

Crée une copie de l'objet ComponentEvent et définit la valeur de chaque paramètre pour correspondre à l'original.

Valeur renvoyée

Event — Nouvel objet ComponentEvent dont les propriétés ont la même valeur que celles de l’objet d'origine.

toString

()

méthode

public override function toString():String

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9.0.28.0

Renvoie une chaîne répertoriant toutes les propriétés de l'objet ComponentEvent. La chaîne est écrite au format suivant :

[ComponentEvent type=valeur bubbles=valeur cancelable=valeur]

Valeur renvoyée

String — Représentation sous forme de chaîne de l’objet ComponentEvent.

Détails de la constante

BUTTON_DOWN

Constante

public static const BUTTON_DOWN:String = "buttonDown"

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9.0.28.0

Définit la valeur de la propriété type d'un objet de l'événement buttonDown.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	Objet qui traite activement l’objet de l'événement avec un écouteur d’événement.
`target`	Objet qui a diffusé l’événement. La cible n'est pas toujours l'objet écoutant l'événement. Pour accéder à l'objet qui écoute l'événement, utilisez la propriété `currentTarget`.

ENTER

Constante

public static const ENTER:String = "enter"

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9.0.28.0

Définit la valeur de la propriété type d'un objet de l'événement enter.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	Objet qui traite activement l’objet de l'événement avec un écouteur d’événement.
`target`	Objet qui a diffusé l’événement. La cible n'est pas toujours l'objet écoutant l'événement. Pour accéder à l'objet qui écoute l'événement, utilisez la propriété `currentTarget`.

HIDE

Constante

public static const HIDE:String = "hide"

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9.0.28.0

Définit la valeur de la propriété type d'un objet de l'événement hide.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	Objet qui traite activement l’objet de l'événement avec un écouteur d’événement.
`target`	Objet qui a diffusé l’événement. La cible n'est pas toujours l'objet écoutant l'événement. Pour accéder à l'objet qui écoute l'événement, utilisez la propriété `currentTarget`.

Voir aussi

SHOW

Exemple

L'exemple suivant crée un composant Button qui inverse la visibilité d'un composant 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"

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9.0.28.0

Définit la valeur de la propriété type d'un objet événement labelChange.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	Objet qui traite activement l’objet de l'événement avec un écouteur d’événement.
`target`	Objet qui a diffusé l’événement. La cible n'est pas toujours l'objet écoutant l'événement. Pour accéder à l'objet qui écoute l'événement, utilisez la propriété `currentTarget`.

MOVE

Constante

public static const MOVE:String = "move"

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9.0.28.0

Définit la valeur de la propriété type d'un objet de l'événement move.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	Objet qui traite activement l’objet de l'événement avec un écouteur d’événement.
`target`	Objet qui a diffusé l’événement. La cible n'est pas toujours l'objet écoutant l'événement. Pour accéder à l'objet qui écoute l'événement, utilisez la propriété `currentTarget`.

Exemple

L'exemple suivant repositionne une occurrence du composant UILoader sur la scène en fonction de la valeur d'un composant 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"

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9.0.28.0

Définit la valeur de la propriété type d'un objet de l'événement resize.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	Objet qui traite activement l’objet de l'événement avec un écouteur d’événement.
`target`	Objet qui a diffusé l’événement. La cible n'est pas toujours l'objet écoutant l'événement. Pour accéder à l'objet qui écoute l'événement, utilisez la propriété `currentTarget`.

Exemple

L'exemple suivant charge une image externe dans une occurrence du composant UILoader et la centre sur la scène à l'aide de l'événement resize et de la méthode 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"

Version du langage :

ActionScript 3.0

Version du lecteur :

Flash Player 9.0.28.0

Définit la valeur de la propriété type d'un objet de l'événement show.

Les propriétés de cet événement sont les suivantes :

Propriété	Valeur
`bubbles`	`false`
`cancelable`	`false` ; il n’existe aucun comportement par défaut à annuler.
`currentTarget`	Objet qui traite activement l’objet de l'événement avec un écouteur d’événement.
`target`	Objet qui a diffusé l’événement. La cible n'est pas toujours l'objet écoutant l'événement. Pour accéder à l'objet qui écoute l'événement, utilisez la propriété `currentTarget`.

Voir aussi

HIDE

Exemple

L'exemple suivant crée un composant Button qui inverse la visibilité d'un composant 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);
}

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/fl/events/ComponentEvent.html

Guide de référence du langage et des composants ActionScript 3.0		Tous les packages \| Toutes les classes \| Eléments du langage \| Index \| Annexes \| Conventions \| Cadres Aucune image
ComponentEvent	Propriétés \| Méthodes \| Constantes

Package	fl.events
Classe	public class ComponentEvent
Héritage	ComponentEvent Event Object