ComponentEvent

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

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

La classe ComponentEvent définit les événements associés à la classe UIComponent. Parmi ces événements figurent, notamment :

ComponentEvent.BUTTON_DOWN : diffusé après un appui sur un bouton.
ComponentEvent.ENTER : diffusé après un appui sur la touche Entrée.
ComponentEvent.HIDE : diffusé après l’affectation de la valeur false à la propriété visible d’un composant.
ComponentEvent.LABEL_CHANGE : diffusé après un appui sur la touche Entrée.
ComponentEvent.MOVE : diffusé après un changement des propriétés x ou y qui désignent l’emplacement d’un composant.
ComponentEvent.RESIZE : diffusé après le redimensionnement d’un composant.
ComponentEvent.SHOW : diffusé après l’affectation de la valeur true à la propriété visible d’un composant.

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	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 évité.	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
		target : Object [lecture seule] Cible de l’événement.	Event
		type : String [lecture seule] Type d’événement.	Event

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	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 [override] 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 des classes Event ActionScript 3.0 personnalisées.	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 la méthode 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
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String [override] 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

Constantes publiques

Masquer les constantes publiques héritées

Afficher les constantes publiques héritées

	Constante		Défini par
		BUTTON_DOWN : String = "buttonDown" [statique] Définit la valeur de la propriété type d’un objet de l’événement buttonDown.	ComponentEvent
		ENTER : String = "enter" [statique] Définit la valeur de la propriété type d’un objet de l’événement enter.	ComponentEvent
		HIDE : String = "hide" [statique] Définit la valeur de la propriété type d’un objet de l’événement hide.	ComponentEvent
		LABEL_CHANGE : String = "labelChange" [statique] Définit la valeur de la propriété type d’un objet de l’événement labelChange.	ComponentEvent
		MOVE : String = "move" [statique] Définit la valeur de la propriété type d’un objet d’événement move.	ComponentEvent
		RESIZE : String = "resize" [statique] Définit la valeur de la propriété type d’un objet d’événement resize.	ComponentEvent
		SHOW : String = "show" [statique] Définit la valeur de la propriété type d’un objet de l’événement show.	ComponentEvent

Détails du constructeur

()

Constructeur

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

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.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 du flux d’événements. Les écouteurs d’événement 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énement peuvent accéder à ces informations via la propriété `cancelable` de l’objet de l’événement.

Détails de la méthode

clone

()

méthode

override public function clone():Event

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

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

override public function toString():String

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

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

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.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 distribué 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 produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.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 distribué 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 produit:

Flash CS3

Versions du moteur d’exécution:

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

Eléments de l’API associés

SHOW

Exemple ( Comment utiliser cet 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 produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Définit la valeur de la propriété type d’un objet d’é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 distribué 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 produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Définit la valeur de la propriété type d’un objet d’é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 distribué 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 ( Comment utiliser cet 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 produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Définit la valeur de la propriété type d’un objet d’é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 distribué 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 ( Comment utiliser cet 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 produit:

Flash CS3

Versions du moteur d’exécution:

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

Eléments de l’API associés

HIDE

Exemple ( Comment utiliser cet 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);
}

Informations juridiques | Politique de confidentialité en ligne

ComponentEvent - AS3 Flash

Classes x

ComponentEvent

clone

toString

BUTTON_DOWN

ENTER

HIDE

LABEL_CHANGE

MOVE

RESIZE

SHOW