ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: Pobieranie danych z serwera...
Pobieranie danych z serwera...
mx.effects 

EffectInstance  - AS3 Flex

Pakietmx.effects
Klasapublic class EffectInstance
DziedziczenieEffectInstance Inheritance EventDispatcher Inheritance Object
Implementuje IEffectInstance
Podklasy ActionEffectInstance, AnimateInstance, CompositeEffectInstance, MaskEffectInstance, SoundEffectInstance, TweenEffectInstance

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

The EffectInstance class represents an instance of an effect playing on a target. Each target has a separate effect instance associated with it. An effect instance's lifetime is transitory. An instance is created when the effect is played on a target and is destroyed when the effect has finished playing. If there are multiple effects playing on a target at the same time (for example, a Parallel effect), there is a separate effect instance for each effect.

Effect developers must create an instance class for their custom effects.

Powiązane elementy interfejsu API



Właściwości publiczne
 WłaściwośćZdefiniowane przez
  className : String
[tylko do odczytu] The name of the effect class, such as "FadeInstance".
EffectInstance
 Inheritedconstructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.
Object
  duration : Number
The duration of the effect, in milliseconds.
EffectInstance
  effect : IEffect
The IEffect object that created this IEffectInstance object.
EffectInstance
  effectTargetHost : mx.effects:IEffectTargetHost
A property that lets you access the target list-based control of a data effect.
EffectInstance
  hideFocusRing : Boolean
Determines whether the effect should hide the focus ring when starting the effect.
EffectInstance
  playheadTime : Number
Current time position of the effect.
EffectInstance
  propertyChanges : PropertyChanges
Specifies the PropertyChanges object containing the start and end values for the set of properties relevant to the effect's targets.
EffectInstance
  repeatCount : int
Number of times to repeat the effect.
EffectInstance
  repeatDelay : int
Amount of time, in milliseconds, to wait before repeating the effect.
EffectInstance
  startDelay : int
Amount of time, in milliseconds, to wait before starting the effect.
EffectInstance
  suspendBackgroundProcessing : Boolean
If true, blocks all background processing while the effect is playing.
EffectInstance
  target : Object
The UIComponent object to which this effect is applied.
EffectInstance
  triggerEvent : Event
The event, if any, which triggered the playing of the effect.
EffectInstance
Właściwości chronione
 WłaściwośćZdefiniowane przez
  playCount : int = 0
Number of times that the instance has been played.
EffectInstance
Metody publiczne
 MetodaZdefiniowane przez
  
Constructor.
EffectInstance
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.
EventDispatcher
 Inherited
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.
EventDispatcher
  
Interrupts an effect instance that is currently playing, and jumps immediately to the end of the effect.
EffectInstance
  
Called by the end() method when the effect finishes playing.
EffectInstance
  
Called after each iteration of a repeated effect finishes playing.
EffectInstance
 Inherited
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.
EventDispatcher
 Inherited
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
  
This method is called if the effect was triggered by the EffectManager.
EffectInstance
 Inherited
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
  
Pauses the effect until you call the resume() method.
EffectInstance
  
Plays the effect instance on the target.
EffectInstance
 Inherited
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Usuwa detektor z obiektu EventDispatcher.
EventDispatcher
  
Resumes the effect after it has been paused by a call to the pause() method.
EffectInstance
  
Plays the effect in reverse, starting from the current position of the effect.
EffectInstance
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
  
Plays the effect instance on the target after the startDelay period has elapsed.
EffectInstance
  
Stops the effect, leaving the target in its current state.
EffectInstance
 Inherited
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
 Inherited
Zwraca ciąg reprezentujący określony obiekt.
Object
 Inherited
Zwraca pierwotną wartość dla określonego obiektu.
Object
 Inherited
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.
EventDispatcher
Zdarzenia
 Zdarzenie Podsumowanie Zdefiniowane przez
 Inherited[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.EventDispatcher
 Inherited[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.EventDispatcher
Szczegół właściwości

className

właściwość
className:String  [tylko do odczytu]

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

The name of the effect class, such as "FadeInstance".

This is a short or "unqualified" class name that does not include the package name. If you need the qualified name, use the getQualifiedClassName() method in the flash.utils package.



Implementacja
    public function get className():String

duration

właściwość 
duration:Number

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

The duration of the effect, in milliseconds.



Implementacja
    public function get duration():Number
    public function set duration(value:Number):void

effect

właściwość 
effect:IEffect

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

The IEffect object that created this IEffectInstance object.



Implementacja
    public function get effect():IEffect
    public function set effect(value:IEffect):void

effectTargetHost

właściwość 
effectTargetHost:mx.effects:IEffectTargetHost

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

A property that lets you access the target list-based control of a data effect. This property enables an instance of an effect class to communicate with the list-based control on which the effect is playing.



Implementacja
    public function get effectTargetHost():mx.effects:IEffectTargetHost
    public function set effectTargetHost(value:mx.effects:IEffectTargetHost):void

hideFocusRing

właściwość 
hideFocusRing:Boolean

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Determines whether the effect should hide the focus ring when starting the effect. The effect target is responsible for the hiding the focus ring. Subclasses of the UIComponent class hide the focus ring automatically. If the effect target is not a subclass of the UIComponent class, you must add functionality to it to hide the focus ring.

Set this property to true to hide the focus ring during the effect.

For subclasses of Effect, the default value is false. For subclasses of MaskEffect, the default value is true.



Implementacja
    public function get hideFocusRing():Boolean
    public function set hideFocusRing(value:Boolean):void

playCount

właściwość 
protected var playCount:int = 0

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Number of times that the instance has been played.

playheadTime

właściwość 
playheadTime:Number

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Current time position of the effect. This property has a value between 0 and the total duration, which includes the Effect's startDelay, repeatCount, and repeatDelay.



Implementacja
    public function get playheadTime():Number
    public function set playheadTime(value:Number):void

propertyChanges

właściwość 
propertyChanges:PropertyChanges

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Specifies the PropertyChanges object containing the start and end values for the set of properties relevant to the effect's targets. This property is only set if the captureStartValues() method was called on the effect that created this effect instance.

You often use the propertyChanges property to create an effect that is used as part of a transition. Flex automatically calls the captureStartValues() method when it starts a transition. Within your override of the Effectinstance.play() method, you can examine the information within the propertyChanges() method to initialize the start and end values of the effect.



Implementacja
    public function get propertyChanges():PropertyChanges
    public function set propertyChanges(value:PropertyChanges):void

repeatCount

właściwość 
repeatCount:int

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Number of times to repeat the effect. Possible values are any integer greater than or equal to 0.



Implementacja
    public function get repeatCount():int
    public function set repeatCount(value:int):void

repeatDelay

właściwość 
repeatDelay:int

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Amount of time, in milliseconds, to wait before repeating the effect.



Implementacja
    public function get repeatDelay():int
    public function set repeatDelay(value:int):void

startDelay

właściwość 
startDelay:int

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Amount of time, in milliseconds, to wait before starting the effect. Possible values are any int greater than or equal to 0. If the effect is repeated by using the repeatCount property, the startDelay property is applied only the first time the effect is played.



Implementacja
    public function get startDelay():int
    public function set startDelay(value:int):void

suspendBackgroundProcessing

właściwość 
suspendBackgroundProcessing:Boolean

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

If true, blocks all background processing while the effect is playing. Background processing includes measurement, layout, and processing responses that have arrived from the server.



Implementacja
    public function get suspendBackgroundProcessing():Boolean
    public function set suspendBackgroundProcessing(value:Boolean):void

target

właściwość 
target:Object

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

The UIComponent object to which this effect is applied.



Implementacja
    public function get target():Object
    public function set target(value:Object):void

triggerEvent

właściwość 
triggerEvent:Event

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

The event, if any, which triggered the playing of the effect. This property is useful when an effect is assigned to multiple triggering events.

If the effect was played programmatically by a call to the play() method, rather than being triggered by an event, this property is null.



Implementacja
    public function get triggerEvent():Event
    public function set triggerEvent(value:Event):void
Konstruktor Szczegół

EffectInstance

()Konstruktor
public function EffectInstance(target:Object)

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Constructor.

Parametry
target:Object — UIComponent object to animate with this effect.
Szczegół metody

end

()metoda
public function end():void

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Interrupts an effect instance that is currently playing, and jumps immediately to the end of the effect. This method is invoked by a call to the Effect.end() method. As part of its implementation, it calls the finishEffect() method.

The effect instance dispatches an effectEnd event when you call this method as part of ending the effect.

In a subclass of EffectInstance, you can optionally override this method As part of your override, you should call the super.end() method from the end of your override, after your logic.

finishEffect

()metoda 
public function finishEffect():void

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Called by the end() method when the effect finishes playing. This function dispatches an endEffect event for the effect target.

You do not have to override this method in a subclass. You do not need to call this method when using effects, but you may need to call it if you create an effect subclass.

finishRepeat

()metoda 
public function finishRepeat():void

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Called after each iteration of a repeated effect finishes playing.

You do not have to override this method in a subclass. You do not need to call this method when using effects.

initEffect

()metoda 
public function initEffect(event:Event):void

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

This method is called if the effect was triggered by the EffectManager. This base class version saves the event that triggered the effect in the triggerEvent property. Each subclass should override this method.

Parametry

event:Event — The Event object that was dispatched to trigger the effect. For example, if the trigger was a mouseDownEffect, the event would be a MouseEvent with type equal to MouseEvent.MOUSEDOWN.

pause

()metoda 
public function pause():void

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Pauses the effect until you call the resume() method.

play

()metoda 
public function play():void

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Plays the effect instance on the target. Call the startEffect() method instead to make an effect start playing on an EffectInstance.

In a subclass of EffectInstance, you must override this method. The override must call the super.play() method so that an effectStart event is dispatched from the target.

resume

()metoda 
public function resume():void

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Resumes the effect after it has been paused by a call to the pause() method.

reverse

()metoda 
public function reverse():void

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Plays the effect in reverse, starting from the current position of the effect.

startEffect

()metoda 
public function startEffect():void

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Plays the effect instance on the target after the startDelay period has elapsed. Called by the Effect class. Use this function instead of the play() method when starting an EffectInstance.

stop

()metoda 
public function stop():void

Wersja języka: ActionScript 3.0
Wersja produktu: Flex 3
Wersje środowiska wykonawczego: Flash Player 9, AIR 1.1

Stops the effect, leaving the target in its current state. This method is invoked by a call to the Effect.stop() method. As part of its implementation, it calls the finishEffect() method.

The effect instance dispatches an effectEnd event when you call this method as part of ending the effect.





[ X ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.