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.effectClasses 

MaskEffectInstance  - AS3 Flex

Pakietmx.effects.effectClasses
Klasapublic class MaskEffectInstance
DziedziczenieMaskEffectInstance Inheritance EffectInstance Inheritance EventDispatcher Inheritance Object
Podklasy IrisInstance, WipeDownInstance, WipeLeftInstance, WipeRightInstance, WipeUpInstance

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

The MaskEffectInstance class is an abstract base class that implements the instance class for the MaskEffect class.

Every effect class that is a subclass of the TweenEffect class supports the following events:

  • tweenEnd: Dispatched when the tween effect ends.
  • tweenUpdate: Dispatched every time a TweenEffect class calculates a new value.

The event object passed to the event listener for these events is of type TweenEvent. The TweenEvent class defines the property value, which contains the tween value calculated by the effect. For the Mask effect, the TweenEvent.value property contains a 4-item Array, where:

  • value[0]:Number The value of the target's x property.
  • value[1]:Number The value of the target's y property.
  • value[2]:Number The value of the target's scaleX property.
  • value[3]:Number The value of the target's scaleY property.

Powiązane elementy interfejsu API



Właściwości publiczne
 WłaściwośćZdefiniowane przez
 InheritedclassName : 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
  createMaskFunction : Function
Function called when the effect creates the mask.
MaskEffectInstance
 Inheritedduration : Number
The duration of the effect, in milliseconds.
EffectInstance
 Inheritedeffect : IEffect
The IEffect object that created this IEffectInstance object.
EffectInstance
 InheritedeffectTargetHost : mx.effects:IEffectTargetHost
A property that lets you access the target list-based control of a data effect.
EffectInstance
 InheritedhideFocusRing : Boolean
Determines whether the effect should hide the focus ring when starting the effect.
EffectInstance
  moveEasingFunction : Function
Easing function to use for moving the mask.
MaskEffectInstance
 InheritedplayheadTime : Number
Current time position of the effect.
EffectInstance
 InheritedpropertyChanges : PropertyChanges
Specifies the PropertyChanges object containing the start and end values for the set of properties relevant to the effect's targets.
EffectInstance
 InheritedrepeatCount : int
Number of times to repeat the effect.
EffectInstance
 InheritedrepeatDelay : int
Amount of time, in milliseconds, to wait before repeating the effect.
EffectInstance
  scaleEasingFunction : Function
Easing function to use for scaling the mask.
MaskEffectInstance
  scaleXFrom : Number
Initial scaleX for mask.
MaskEffectInstance
  scaleXTo : Number
Ending scaleX for mask.
MaskEffectInstance
  scaleYFrom : Number
Initial scaleY for mask.
MaskEffectInstance
  scaleYTo : Number
Ending scaleY for mask.
MaskEffectInstance
  showTarget : Boolean
Specifies that the target component is becoming visible, false, or invisible, true.
MaskEffectInstance
 InheritedstartDelay : int
Amount of time, in milliseconds, to wait before starting the effect.
EffectInstance
 InheritedsuspendBackgroundProcessing : Boolean
If true, blocks all background processing while the effect is playing.
EffectInstance
 Inheritedtarget : Object
The UIComponent object to which this effect is applied.
EffectInstance
  targetArea : Rectangle
The area where the mask is applied on the target.
MaskEffectInstance
 InheritedtriggerEvent : Event
The event, if any, which triggered the playing of the effect.
EffectInstance
  xFrom : Number
Initial position's x coordinate for mask.
MaskEffectInstance
  xTo : Number
Destination position's x coordinate for mask.
MaskEffectInstance
  yFrom : Number
Initial position's y coordinate for mask.
MaskEffectInstance
  yTo : Number
Destination position's y coordinate for mask.
MaskEffectInstance
Właściwości chronione
 WłaściwośćZdefiniowane przez
  effectMask : Shape
Contains the effect mask, either the default mask created by the defaultCreateMask() method, or the one specified by the function passed to the createMaskFunction property.
MaskEffectInstance
 InheritedplayCount : int = 0
Number of times that the instance has been played.
EffectInstance
  targetVisualBounds : Rectangle
The actual size of the effect target, including any drop shadows.
MaskEffectInstance
Metody publiczne
 MetodaZdefiniowane przez
  
Constructor.
MaskEffectInstance
 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
 Inherited
Interrupts an effect instance that is currently playing, and jumps immediately to the end of the effect.
EffectInstance
 Inherited
Called by the end() method when the effect finishes playing.
EffectInstance
 Inherited
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
 Inherited
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
  
[przesłanianie] Pauses the effect until you call the resume() method.
MaskEffectInstance
 Inherited
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
  
[przesłanianie] Resumes the effect after it has been paused by a call to the pause() method.
MaskEffectInstance
  
[przesłanianie] Plays the effect in reverse, starting from the current position of the effect.
MaskEffectInstance
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
 Inherited
Plays the effect instance on the target after the startDelay period has elapsed.
EffectInstance
 Inherited
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
Metody chronione
 MetodaZdefiniowane przez
  
Creates the default mask for the effect.
MaskEffectInstance
  
Initializes the move and scale properties of the effect.
MaskEffectInstance
  
Callback method that is called when the x and y position of the mask should be updated by the effect for the last time.
MaskEffectInstance
  
Callback method that is called when the x and y position of the mask should be updated by the effect.
MaskEffectInstance
  
Callback method that is called when the scaleX and scaleY properties of the mask should be updated by the effect for the last time.
MaskEffectInstance
  
Callback method that is called when the scaleX and scaleY properties of the mask should be updated by the effect.
MaskEffectInstance
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

createMaskFunction

właściwość
createMaskFunction:Function

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

Function called when the effect creates the mask. The default value is a function that returns a Rectangle with the same dimensions as the effect target.

You can use this property to specify your own callback function to draw the mask. The function must have the following signature:

	  public function createLargeMask(targ:Object, bounds:Rectangle):Shape {
	    var myMask:Shape = new Shape();
	    // Create mask.
	  
	    return myMask;
	  }
	  

You set this property to the name of the function, as the following example shows for the WipeLeft effect:

	    <mx:WipeLeft id="showWL" createMaskFunction="createLargeMask" showTarget="false"/>



Implementacja
    public function get createMaskFunction():Function
    public function set createMaskFunction(value:Function):void

effectMask

właściwość 
protected var effectMask:Shape

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

Contains the effect mask, either the default mask created by the defaultCreateMask() method, or the one specified by the function passed to the createMaskFunction property.

moveEasingFunction

właściwość 
public var moveEasingFunction:Function

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

Easing function to use for moving the mask.

scaleEasingFunction

właściwość 
public var scaleEasingFunction:Function

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

Easing function to use for scaling the mask.

scaleXFrom

właściwość 
public var scaleXFrom:Number

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

Initial scaleX for mask.

scaleXTo

właściwość 
public var scaleXTo:Number

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

Ending scaleX for mask.

scaleYFrom

właściwość 
public var scaleYFrom:Number

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

Initial scaleY for mask.

scaleYTo

właściwość 
public var scaleYTo:Number

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

Ending scaleY for mask.

showTarget

właściwość 
showTarget:Boolean

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

Specifies that the target component is becoming visible, false, or invisible, true.

Wartością domyślną jest true.



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

targetArea

właściwość 
public var targetArea:Rectangle

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

The area where the mask is applied on the target. The dimensions are relative to the target itself. By default, the area is the entire target and is created like this: new Rectangle(0, 0, target.width, target.height);

targetVisualBounds

właściwość 
protected var targetVisualBounds:Rectangle

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

The actual size of the effect target, including any drop shadows. Flex calculates the value of this property; you do not have to set it.

xFrom

właściwość 
public var xFrom:Number

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

Initial position's x coordinate for mask.

xTo

właściwość 
public var xTo:Number

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

Destination position's x coordinate for mask.

yFrom

właściwość 
public var yFrom:Number

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

Initial position's y coordinate for mask.

yTo

właściwość 
public var yTo:Number

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

Destination position's y coordinate for mask.

Konstruktor Szczegół

MaskEffectInstance

()Konstruktor
public function MaskEffectInstance(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 — The Object to animate with this effect.
Szczegół metody

defaultCreateMask

()metoda
protected function defaultCreateMask(targ:Object, bounds:Rectangle):Shape

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

Creates the default mask for the effect.

Parametry

targ:Object — The effect target.
 
bounds:Rectangle — The actual visual bounds of the target which includes drop shadows

Zwraca
Shape — A Shape object that defines the mask.

initMaskEffect

()metoda 
protected function initMaskEffect():void

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

Initializes the move and scale properties of the effect. All subclasses should override this function. Flex calls it after the mask has been created, but before the tweens are created.

onMoveTweenEnd

()metoda 
protected function onMoveTweenEnd(value:Object):void

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

Callback method that is called when the x and y position of the mask should be updated by the effect for the last time. You do not call this method directly. This method implements the method of the superclass.

Parametry

value:Object — Contains the final x and y value for the mask position, where value[0] contains the x position of the mask, and value[1] contains the y position.

onMoveTweenUpdate

()metoda 
protected function onMoveTweenUpdate(value:Object):void

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

Callback method that is called when the x and y position of the mask should be updated by the effect. You do not call this method directly. This method implements the method of the superclass.

Parametry

value:Object — Contains an interpolated x and y value for the mask position, where value[0] contains the new x position of the mask, and value[1] contains the new y position.

onScaleTweenEnd

()metoda 
protected function onScaleTweenEnd(value:Object):void

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

Callback method that is called when the scaleX and scaleY properties of the mask should be updated by the effect for the last time. You do not call this method directly. This method implements the method of the superclass.

Parametry

value:Object — Contains the final scaleX and scaleY value for the mask, where value[0] contains the scaleX value of the mask, and value[1] contains the scaleY value.

onScaleTweenUpdate

()metoda 
protected function onScaleTweenUpdate(value:Object):void

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

Callback method that is called when the scaleX and scaleY properties of the mask should be updated by the effect. You do not call this method directly. This method implements the method of the superclass.

Parametry

value:Object — Contains an interpolated scaleX and scaleY value for the mask, where value[0] contains the new scaleX value of the mask, and value[1] contains the new scaleY value.

pause

()metoda 
override 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.

resume

()metoda 
override 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 
override 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.





[ 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.