ComponentEvent

Paket	fl.events
Klasse	public class ComponentEvent
Vererbung	ComponentEvent Event Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Die ComponentEvent-Klasse definiert die Ereignisse, die mit der UIComponent-Klasse verknüpft sind. Zu diesen Ereignissen gehören:

ComponentEvent.BUTTON_DOWN: Wird ausgelöst, wenn eine Schaltfläche gedrückt wird.
ComponentEvent.ENTER: Wird ausgelöst, wenn die Eingabetaste gedrückt wird.
ComponentEvent.HIDE: Wird ausgelöst, wenn die sichtbare Eigenschaft einer Komponente auf false gesetzt wird.
ComponentEvent.LABEL_CHANGE: Wird ausgelöst, wenn die Eingabetaste gedrückt wird.
ComponentEvent.MOVE: Wird ausgelöst, wenn eine Änderung an den x- oder y-Eigenschaften vorgenommen wird, die die Position der Komponenten identifizieren.
ComponentEvent.RESIZE: Wird ausgelöst, wenn die Größe einer Komponente geändert wird.
ComponentEvent.SHOW: Wird ausgelöst, wenn die visible-Eigenschaft einer Komponente auf true gesetzt wird.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		bubbles : Boolean [schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.	Event
		cancelable : Boolean [schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.	Event
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		currentTarget : Object [schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.	Event
		eventPhase : uint [schreibgeschützt] Die aktuelle Phase im Ereignisablauf.	Event
		target : Object [schreibgeschützt] Das Ereignis-Ziel.	Event
		type : String [schreibgeschützt] Der Ereignistyp.	Event

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		ComponentEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false) Erstellt ein neues ComponentEvent-Objekt, das Informationen über ein Komponentenereignis enthält.	ComponentEvent
		clone():Event [override] Erstellt eine Kopie des ComponentEvent-Objekts und stellt die Werte der einzelnen Parameter so ein, dass sie den Werten des Originals entsprechen.	ComponentEvent
		formatToString(className:String, ... arguments):String Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.	Event
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isDefaultPrevented():Boolean Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.	Event
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		preventDefault():void Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.	Event
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		stopImmediatePropagation():void Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.	Event
		stopPropagation():void Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.	Event
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String [override] Gibt einen String zurück, der alle Eigenschaften des ComponentEvent-Objekts enthält.	ComponentEvent
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Öffentliche Konstanten

Vererbte öffentliche Konstanten ausblenden

Vererbte öffentliche Konstanten anzeigen

	Konstante		Definiert von
		BUTTON_DOWN : String = "buttonDown" [statisch] Definiert den Wert der type-Eigenschaft eines buttonDown-Ereignisobjekts.	ComponentEvent
		ENTER : String = "enter" [statisch] Definiert den Wert der type-Eigenschaft eines enter-Ereignisobjekts.	ComponentEvent
		HIDE : String = "hide" [statisch] Definiert den Wert der type-Eigenschaft eines hide-Ereignisobjekts.	ComponentEvent
		LABEL_CHANGE : String = "labelChange" [statisch] Definiert den Wert der type-Eigenschaft eines labelChange-Ereignisobjekts.	ComponentEvent
		MOVE : String = "move" [statisch] Definiert den Wert der type-Eigenschaft eines move-Ereignisobjekts.	ComponentEvent
		RESIZE : String = "resize" [statisch] Definiert den Wert der Eigenschaft type eines resize-Ereignisobjekts.	ComponentEvent
		SHOW : String = "show" [statisch] Definiert den Wert der type-Eigenschaft eines show-Ereignisobjekts.	ComponentEvent

Konstruktordetails

()

Konstruktor

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

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Erstellt ein neues ComponentEvent-Objekt, das Informationen über ein Komponentenereignis enthält. Ein ComponentEvent-Objekt wird als Parameter an einen Ereignis-Listener übergeben.

Parameter

	`type:String` — Der Ereignistyp. Ereignis-Listener können über die `type`-Eigenschaft des Ereignisobjekts auf diese Informationen zugreifen. Eine Komponente kann die folgenden Ereignistypen aufweisen: `ComponentEvent.BUTTON_DOWN`, `ComponentEvent.ENTER`, `ComponentEvent.HIDE`, `ComponentEvent.LABEL_CHANGE`, `ComponentEvent.MOVE`, `ComponentEvent.RESIZE`, `ComponentEvent.SHOW`.

	`bubbles:Boolean` (default = `false`) — Legt fest, ob das ComponentEvent-Objekt an der Bubbling-Phase des Ereignisablaufs teilnimmt. Ereignis-Listener können über die `bubbles`-Eigenschaft des Ereignisobjekts auf diese Informationen zugreifen.

	`cancelable:Boolean` (default = `false`) — Legt fest, ob das ComponentEvent-Objekt abgebrochen werden kann. Ereignis-Listener können über die `cancelable`-Eigenschaft des Ereignisobjekts auf diese Informationen zugreifen.

Methodendetails

clone

()

Methode

override public function clone():Event

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Erstellt eine Kopie des ComponentEvent-Objekts und stellt die Werte der einzelnen Parameter so ein, dass sie den Werten des Originals entsprechen.

Rückgabewerte

Event — Ein neues ComponentEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.

toString

()

Methode

override public function toString():String

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Gibt einen String zurück, der alle Eigenschaften des ComponentEvent-Objekts enthält. Der String liegt im folgenden Format vor:

[ComponentEvent type=Wert bubbles=Wert cancelable=Wert]

Rückgabewerte

String — Eine Stringdarstellung des ComponentEvent-Objekts.

Konstantendetails

BUTTON_DOWN

Konstante

public static const BUTTON_DOWN:String = "buttonDown"

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Definiert den Wert der Eigenschaft type eines buttonDown-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft `currentTarget`, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.

ENTER

Konstante

public static const ENTER:String = "enter"

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Definiert den Wert der Eigenschaft type eines enter-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft `currentTarget`, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.

HIDE

Konstante

public static const HIDE:String = "hide"

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Definiert den Wert der Eigenschaft type eines hide-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft `currentTarget`, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.

Verwandte API-Elemente

SHOW

Beispiel ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird eine Button-Komponente erstellt, mit der die Sichtbarkeit einer List-Komponente umgeschaltet wird:


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

Konstante

public static const LABEL_CHANGE:String = "labelChange"

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Definiert den Wert der Eigenschaft type eines labelChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft `currentTarget`, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.

MOVE

Konstante

public static const MOVE:String = "move"

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Definiert den Wert der Eigenschaft type eines move-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft `currentTarget`, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.

Beispiel ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird eine Instanz der UILoader-Komponente anhand des Werts der Slider-Komponente erneut auf der Bühne platziert.


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

Konstante

public static const RESIZE:String = "resize"

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Definiert den Wert der Eigenschaft type eines resize-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft `currentTarget`, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.

Beispiel ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird ein externes Bild in eine Instanz der UILoader-Komponente geladen und mithilfe des Ereignisse resize und der Methode move() auf der Bühne zentriert:


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

Konstante

public static const SHOW:String = "show"

Sprachversion:

ActionScript 3.0

Produktversion:

Flash CS3

Laufzeitversionen:

Flash Player 9.0.28.0, AIR 1.0

Definiert den Wert der Eigenschaft type eines show-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Eigenschaft	Wert
`bubbles`	`false`
`cancelable`	`false`. Es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Das Ziel ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die Eigenschaft `currentTarget`, um auf das Objekt zuzugreifen, das auf das Ereignis wartet.

Verwandte API-Elemente

HIDE

Beispiel ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird eine Button-Komponente erstellt, mit der die Sichtbarkeit einer List-Komponente umgeschaltet wird:


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

Rechtliche Hinweise | Onlinedatenschutzerklärung

ComponentEvent - AS3 Flash

Klassen x

ComponentEvent

clone

toString

BUTTON_DOWN

ENTER

HIDE

LABEL_CHANGE

MOVE

RESIZE

SHOW