ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
fl.events 

ComponentEvent  - AS3 Flash

Paketfl.events
Klassepublic class ComponentEvent
VererbungComponentEvent Inheritance Event Inheritance 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
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[schreibgeschützt] Die aktuelle Phase im Ereignisablauf.
Event
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
ComponentEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false)
Erstellt ein neues ComponentEvent-Objekt, das Informationen über ein Komponentenereignis enthält.
ComponentEvent
  
[override] Erstellt eine Kopie des ComponentEvent-Objekts und stellt die Werte der einzelnen Parameter so ein, dass sie den Werten des Originals entsprechen.
ComponentEvent
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
  
[override] Gibt einen String zurück, der alle Eigenschaften des ComponentEvent-Objekts enthält.
ComponentEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert 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

ComponentEvent

()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:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas 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:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas 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:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas 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


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:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas 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:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas 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:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas 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:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas 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


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




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.