ComponentEvent

Pakiet	fl.events
Klasa	public class ComponentEvent
Dziedziczenie	ComponentEvent Event Object

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Klasa ComponentEvent definiuje zdarzenia skojarzone z klasą UIComponent. Są to następujące zdarzenia:

ComponentEvent.BUTTON_DOWN: wywoływane po naciśnięciu przycisku.
ComponentEvent.ENTER: wywoływane po naciśnięciu klawisza Enter.
ComponentEvent.HIDE: wywoływane po ustawieniu właściwości visible składnika na false.
ComponentEvent.LABEL_CHANGE: wywoływana po naciśnięciu klawisza Enter.
ComponentEvent.MOVE: wywoływane po zmianie właściwości x lub y określający położenie składnika.
ComponentEvent.RESIZE: wywoływane po zmianie rozmiaru składnika.
ComponentEvent.SHOW: wywoływane po ustawieniu właściwości visible składnika na true.

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		bubbles : Boolean [tylko do odczytu] Określa, czy zdarzenie może przechodzić fazę propagacji.	Event
		cancelable : Boolean [tylko do odczytu] Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem.	Event
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		currentTarget : Object [tylko do odczytu] Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.	Event
		eventPhase : uint [tylko do odczytu] Bieżąca faza przepływu zdarzeń.	Event
		target : Object [tylko do odczytu] Miejsce docelowe zdarzenia.	Event
		type : String [tylko do odczytu] Typ zdarzenia.	Event

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		ComponentEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false) Tworzy nowy obiekt ComponentEvent, który zawiera informacje o zdarzeniu składowym.	ComponentEvent
		clone():Event [przesłanianie] Tworzy kopię obiektu ComponentEvent i ustawia wartości poszczególnych parametrów zgodnie z parametrami oryginału.	ComponentEvent
		formatToString(className:String, ... arguments):String Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0.	Event
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isDefaultPrevented():Boolean Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault().	Event
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		preventDefault():void Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane.	Event
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		stopImmediatePropagation():void Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim.	Event
		stopPropagation():void Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń.	Event
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String [przesłanianie] Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu ComponentEvent.	ComponentEvent
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object

Stałe publiczne

Ukryj dziedziczone stałe publiczne

Pokaż dziedziczone stałe publiczne

	Stała		Zdefiniowane przez
		BUTTON_DOWN : String = "buttonDown" [statyczny] Definiuje wartość właściwości type obiektu zdarzenia buttonDown.	ComponentEvent
		ENTER : String = "enter" [statyczny] Definiuje wartość właściwości type obiektu zdarzenia enter.	ComponentEvent
		HIDE : String = "hide" [statyczny] Definiuje wartość właściwości type obiektu zdarzenia hide.	ComponentEvent
		LABEL_CHANGE : String = "labelChange" [statyczny] Definiuje wartość właściwości type obiektu zdarzenia labelChange.	ComponentEvent
		MOVE : String = "move" [statyczny] Definiuje wartość właściwości type obiektu zdarzenia move.	ComponentEvent
		RESIZE : String = "resize" [statyczny] Definiuje wartość właściwości type obiektu zdarzenia resize.	ComponentEvent
		SHOW : String = "show" [statyczny] Definiuje wartość właściwości type obiektu zdarzenia show.	ComponentEvent

Konstruktor Szczegół

()

Konstruktor

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Tworzy nowy obiekt ComponentEvent, który zawiera informacje o zdarzeniu składowym. Obiekt ComponentEvent jest przekazywany jako parametr do detektora zdarzeń.

Parametry

	`type:String` — Typ zdarzenia. Detektory zdarzeń mogą odczytywać tę informację za pośrednictwem właściwości `type` obiektu zdarzenia. Ze składnikiem mogą być związane następujące typy zdarzeń: `ComponentEvent.BUTTON_DOWN`, `ComponentEvent.ENTER`, `ComponentEvent.HIDE`, `ComponentEvent.LABEL_CHANGE`, `ComponentEvent.MOVE`, `ComponentEvent.RESIZE`, `ComponentEvent.SHOW`.

	`bubbles:Boolean` (default = `false`) — Określa, czy obiekt ComponentEvent uczestniczy w fazie propagacji przepływu zdarzeń. Detektory zdarzeń mogą odczytywać tę informację za pośrednictwem właściwości `bubbles` obiektu zdarzenia.

	`cancelable:Boolean` (default = `false`) — Określa, czy obiekt ComponentEvent może być anulowany. Detektory zdarzeń mogą odczytywać tę informację za pośrednictwem właściwości `cancelable` obiektu zdarzenia.

Szczegół metody

clone

()

metoda

override public function clone():Event

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Tworzy kopię obiektu ComponentEvent i ustawia wartości poszczególnych parametrów zgodnie z parametrami oryginału.

Zwraca

Event — Nowy obiekt ComponentEvent z wartościami właściwości zgodnymi z oryginałem.

toString

()

metoda

override public function toString():String

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu ComponentEvent. Format ciągu znaków jest następujący:

[ComponentEvent type=wartość bubbles=wartość cancelable=wartość]

Zwraca

String — Ciąg znaków reprezentujący obiekt ComponentEvent.

Szczegół stałej

BUTTON_DOWN

Stała

public static const BUTTON_DOWN:String = "buttonDown"

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Definiuje wartość właściwości type obiektu zdarzenia buttonDown.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`target`	Obiekt, który wywołał zdarzenie. Celem nie zawsze jest obiekt wykrywający zdarzenie. Aby uzyskać dostęp do obiektu, który wykrywa zdarzenie, należy skorzystać z właściwości `currentTarget`.

ENTER

Stała

public static const ENTER:String = "enter"

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Definiuje wartość właściwości type obiektu zdarzenia enter.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`target`	Obiekt, który wywołał zdarzenie. Celem nie zawsze jest obiekt wykrywający zdarzenie. Aby uzyskać dostęp do obiektu, który wykrywa zdarzenie, należy skorzystać z właściwości `currentTarget`.

HIDE

Stała

public static const HIDE:String = "hide"

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Definiuje wartość właściwości type obiektu zdarzenia hide.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`target`	Obiekt, który wywołał zdarzenie. Celem nie zawsze jest obiekt wykrywający zdarzenie. Aby uzyskać dostęp do obiektu, który wykrywa zdarzenie, należy skorzystać z właściwości `currentTarget`.

Powiązane elementy interfejsu API

SHOW

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje tworzenie składnika Button, który przełącza widoczność składnika 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

Stała

public static const LABEL_CHANGE:String = "labelChange"

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Definiuje wartość właściwości type obiektu zdarzenia labelChange.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`target`	Obiekt, który wywołał zdarzenie. Celem nie zawsze jest obiekt wykrywający zdarzenie. Aby uzyskać dostęp do obiektu, który wykrywa zdarzenie, należy skorzystać z właściwości `currentTarget`.

MOVE

Stała

public static const MOVE:String = "move"

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Definiuje wartość właściwości type obiektu zdarzenia move.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`target`	Obiekt, który wywołał zdarzenie. Celem nie zawsze jest obiekt wykrywający zdarzenie. Aby uzyskać dostęp do obiektu, który wykrywa zdarzenie, należy skorzystać z właściwości `currentTarget`.

Przykład ( Sposób korzystania z tego przykładu )

W poniższym przykładzie wystąpienie składnika UILoader jest przemieszczane na stole montażowym zgodnie z wartością składnika 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

Stała

public static const RESIZE:String = "resize"

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Definiuje wartość właściwości type obiektu zdarzenia resize.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`target`	Obiekt, który wywołał zdarzenie. Celem nie zawsze jest obiekt wykrywający zdarzenie. Aby uzyskać dostęp do obiektu, który wykrywa zdarzenie, należy skorzystać z właściwości `currentTarget`.

Przykład ( Sposób korzystania z tego przykładu )

W poniższym przykładzie obraz zewnętrzny wczytywany jest do wystąpienia składnika UILoader, a następnie jest umieszczany na środku stołu montażowego przy użyciu zdarzenia resize i metody 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

Stała

public static const SHOW:String = "show"

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Definiuje wartość właściwości type obiektu zdarzenia show.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`target`	Obiekt, który wywołał zdarzenie. Celem nie zawsze jest obiekt wykrywający zdarzenie. Aby uzyskać dostęp do obiektu, który wykrywa zdarzenie, należy skorzystać z właściwości `currentTarget`.

Powiązane elementy interfejsu API

HIDE

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje tworzenie składnika Button, który przełącza widoczność składnika 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);
}

Informacje prawne | Zasady prywatności online

ComponentEvent - AS3 Flash

Klasy x

ComponentEvent

clone

toString

BUTTON_DOWN

ENTER

HIDE

LABEL_CHANGE

MOVE

RESIZE

SHOW