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...
spark.effects 

Move3D  - AS3 Flex

Paketspark.effects
Klassepublic class Move3D
VererbungMove3D Inheritance AnimateTransform3D Inheritance AnimateTransform Inheritance Animate Inheritance Effect Inheritance EventDispatcher Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Move3D-Klasse verschiebt ein Zielobjekt in der x-, y- und z-Dimension. Die x-, y- und z-Eigenschaftsangaben des Move3D-Effekts geben die Änderung der x-, y- und z-Werte an, die auf die Transformationsmitte angewendet werden sollen, um die alle Transformationseffekte ausgeführt werden.

Ähnlich wie alle auf AnimateTransform basierenden Effekte funktioniert dieser Effekt nur auf Unterklassen von UIComponent und GraphicElement, da diese Effekte von bestimmten Transformationsfunktionen in diesen Klassen abhängen. Außerdem werden Transformationseffekte, die parallel auf dem gleichen Ziel ausgeführt werden, als eine einzige Effektinstanz ausgeführt. Daher verwenden die Transformationseffekte die gleiche Transformationsmitte, die von einem der Effekte festgelegt wurde.

MXML-SyntaxexpandedMXML-Syntax ausblenden

The <s:Move3D> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <s:Move3D
    Properties
    id="ID"
    xBy="no default"
    xFrom="no default"
    xTo="no default"
    yBy="no default"
    yFrom="no default"
    yTo="no default"
    zBy="no default"
    zFrom="no default"
    zTo="no default"
  />
  

Standard-MXML-EigenschaftmotionPaths

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedapplyChangesPostLayout : Boolean
[override] Von den Unterklassen von AnimateTransform verwendet, um anzugeben, ob der Effekt die vom Layoutmanager verwendeten Transformationswerte ändert, oder ob er die nach der Ausführung des Layouts verwendeten Werte ändert.
AnimateTransform3D
 InheritedapplyLocalProjection : Boolean
Wenn „true“, erstellt der Effekt eine perspektivische Projektion. Dabei werden die anderen projektionsbezogenen Eigenschaften des Effekts verwendet und auf das übergeordnete Objekt der Zielkomponente beim Abspielstart angewendet.
AnimateTransform3D
 InheritedautoCenterProjection : Boolean = true
Setzen Sie den Wert auf „false“, um die Funktion zu deaktivieren, dass ein 3D-Effekt den Projektionspunkt automatisch auf die Mitte des Ziels festlegt.
AnimateTransform3D
 InheritedautoCenterTransform : Boolean = false
Gibt an, ob der Transformationseffekt um die Mitte des Ziels (Breite/2, Höhe/2) herum auftritt, wenn die Wiedergabe des Effekts beginnt.
AnimateTransform
 InheritedclassName : String
[schreibgeschützt] Name der Effektklasse wie „Fade“.
Effect
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcustomFilter : mx.effects:EffectTargetFilter
Gibt ein benutzerdefiniertes Filterobjekt des Typs EffectTargetFilter an, das zur Ermittlung der Ziele dient, bei denen der Effekt wiedergegeben wird.
Effect
 InheriteddisableLayout : Boolean
Wenn der Wert „true“ ist, wird durch den Effekt das Layout auf den übergeordneten Containern der Ziele deaktiviert, indem die autoLayout-Eigenschaft der Container auf „false“ gesetzt wird, und alle Layoutbeschränkungen auf Zielobjekten werden deaktivert.
Animate
 Inheritedduration : Number
Dauer des Effekts in Millisekunden.
Effect
 Inheritedeaser : IEaser
Das Beschleunigungsverhalten für diesen Effekt.
Animate
 InheritedeffectTargetHost : mx.effects:IEffectTargetHost
Eine Eigenschaft, die Ihnen den Zugriff auf listenbasierte Zielsteuerelemente eines Dateneffekts ermöglicht.
Effect
 InheritedfieldOfView : Number
Legt einen Winkel für das dreidimensionale Blickfeld als Gradwert zwischen 0 und 180 fest.
AnimateTransform3D
 Inheritedfilter : String
Gibt einen Algorithmus zum Filtern der Ziele für einen Effekt an.
Effect
 InheritedfocalLength : Number
Der Abstand zwischen dem Auge oder dem Ursprung des Blickpunkts (0,0,0) und dem auf der z-Achse liegenden Anzeigeobjekt.
AnimateTransform3D
 InheritedhideFocusRing : Boolean
Bestimmt, ob der Effekt den Fokusring beim Start ausblenden soll.
Effect
 InheritedinstanceClass : Class
Ein Objekt der type-Klasse, das die Effektinstanzklasse für diese Effektklasse angibt.
Effect
 Inheritedinterpolator : IInterpolator
Der Interpolator, der von diesem Effekt verwendet wird, um Werte zwischen den Anfangs- und Endwerten einer Eigenschaft zu berechnen.
Animate
 InheritedisPlaying : Boolean
[schreibgeschützt] Ein Flag für den Schreibschutz, das auf „true“ gesetzt ist, wenn Instanzen des Effekts aktuell wiedergegeben werden, und andernfalls auf „false“.
Effect
 InheritedperElementOffset : Number
Zusätzliche Verzögerung (in Millisekunden) für Effektziele nach dem ersten Ziel des Effekts.
Effect
 InheritedplayheadTime : Number
Aktuelle Zeitposition des Effekts.
Effect
 InheritedprojectionX : Number = 0
Legt den Projektionspunkt als Offset des Projektionspunkts in der x-Richtung von der Koordinate (0, 0) des Ziels fest.
AnimateTransform3D
 InheritedprojectionY : Number = 0
Legt den Projektionspunkt als Offset des Projektionspunkts in der y-Richtung von der Koordinate (0, 0) des Ziels fest.
AnimateTransform3D
 InheritedrelevantProperties : Array
Ein Array von Eigenschaftsnamen zur Verwendung beim Filtern.
Effect
 InheritedrelevantStyles : Array
Ein Array von Stilnamen zur Verwendung beim Filtern.
Effect
 InheritedremoveLocalProjectionWhenComplete : Boolean = false
Wenn der Wert „true“ ist, entfernt der Effekt die perspektivische Projektion aus dem übergeordneten Element der Zielkomponente, nachdem die Wiedergabe abgeschlossen ist.
AnimateTransform3D
 InheritedstartDelay : int = 0
Wartezeit in Millisekunden vor dem Starten des Effekts.
Effect
 Inheritedtarget : Object
Das Objekt, auf das dieser Effekt angewendet wird.
Effect
 Inheritedtargets : Array
Ein Array von Objekten, die als Ziele des Effekts verwendet werden können.
Effect
 InheritedtransformX : Number
Legt die x-Koordinate für die Transformationsmitte fest, es sei denn, sie wird von der autoCenterTransform-Eigenschaft überschrieben.
AnimateTransform
 InheritedtransformY : Number
Legt die y-Koordinate für die Transformationsmitte fest, es sei denn sie wird von der autoCenterTransform-Eigenschaft überschrieben.
AnimateTransform
 InheritedtransformZ : Number
Legt die z-Koordinate für die Transformationsmitte fest, es sei denn sie wird von der autoCenterTransform-Eigenschaft überschrieben.
AnimateTransform
 InheritedtriggerEvent : Event
Der EffectManager übergibt diesem Effekt das Ereignisobjekt, wenn ein Effekt ausgelöst wird, oder null, wenn der Effekt nicht vom EffectManager wiedergegeben wird.
Effect
  xBy : Number
Die Anzahl an Pixeln, um die die x-Position des Ziels zu ändern ist.
Move3D
  xFrom : Number
Ursprüngliche x-Position des Ziels in Pixeln.
Move3D
  xTo : Number
Abschließende x-Position in Pixeln.
Move3D
  yBy : Number
Die Anzahl an Pixeln, um die die y-Position des Ziels zu ändern ist.
Move3D
  yFrom : Number
Ursprüngliche y-Position des Ziels in Pixeln.
Move3D
  yTo : Number
Abschließende y-Position des Ziels in Pixeln.
Move3D
  zBy : Number
Anzahl der Pixel, um die die z-Position des Ziels geändert werden soll.
Move3D
  zFrom : Number
Ursprüngliche z-Position des Ziels.
Move3D
  zTo : Number
Abschließende z-Position des Ziels.
Move3D
Geschützte Eigenschaften
 EigenschaftDefiniert von
 InheritedapplyTransitionEndProperties : Boolean
Dieses Flag steuert, ob der Effekt, wenn er in einem Übergang ausgeführt wird, automatisch die Eigenschaftswerte des Endstatus anwendet, statt die durch den Effekt eingestellten Werte beizubehalten.
Effect
 InheritedendValuesCaptured : Boolean = false
Wenn dieses Flag auf „true“ gesetzt ist, wurden die Werte eines Effekts bereits bestimmt. Bei „false“ werden die Werte beim Ausführen des Effekts aus den aktuellen Eigenschaften der Effektziele übernommen.
Effect
Öffentliche Methoden
 MethodeDefiniert von
  
Move3D(target:Object = null)
Konstruktor.
Move3D
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
 Inherited
Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts und speichert sie als Endwerte.
Effect
 Inherited
Erfasst die aktuellen Werte der relevanten Eigenschaften eines zusätzlichen Zielsatzes. Flex verwendet diese Funktion, wenn ein Datenänderungseffekt ausgeführt wird.
Effect
 Inherited
Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts.
Effect
 Inherited
Erstellt eine einzelne Effektinstanz und initialisiert sie.
Effect
 Inherited
createInstances(targets:Array = null):Array
Verwendet ein Array von Zielobjekten und ruft die createInstance()-Methode auf jedem Ziel auf.
Effect
 Inherited
Entfernt Ereignis-Listener von einer Instanz und entfernt sie aus der Liste der Instanzen.
Effect
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
end(effectInstance:IEffectInstance = null):void
Unterbricht einen aktuell wiedergegebenen Effekt und springt sofort zum Ende des Effekts.
Effect
 Inherited
Gibt ein Array von Strings zurück, wobei jeder String dem Namen einer Eigenschaft entspricht, die von diesem Effekt geändert wird.
Effect
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Hält den Effekt an, bis die resume()-Methode aufgerufen wird.
Effect
 Inherited
play(targets:Array = null, playReversedFromEnd:Boolean = false):Array
Startet die Wiedergabe des Effekts.
Effect
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde.
Effect
 Inherited
Gibt den aktuell wiedergegebenen Effekt rückwärts wieder und beginnt dabei an der aktuellen Position des Effekts.
Effect
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Hält den Effekt an und behält den aktuellen Status der Effektziele bei.
Effect
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Geschützte Methoden
 MethodeDefiniert von
 Inherited
applyValueToTarget(target:Object, property:String, value:*, props:Object):void
Wird intern von der Effektinfrastruktur verwendet.
Effect
 Inherited
Wird aufgerufen, wenn die Wiedergabe einer Effektinstanz abgeschlossen ist.
Effect
 Inherited
Diese Methode wird aufgerufen, wenn die Wiedergabe der Effektinstanz beginnt.
Effect
 Inherited
Wird aufgerufen, wenn eine Effektinstanz durch einen Aufruf der stop()-Methode angehalten wurde.
Effect
 Inherited
filterInstance(propChanges:Array, target:Object):Boolean
Bestimmt die Logik zum Filtern einer Effektinstanz.
Effect
 Inherited
getValueFromTarget(target:Object, property:String):*
Wird von der captureStartValues()-Methode aufgerufen, um den Wert einer Eigenschaft des Ziels abzurufen.
Effect
 Inherited
Kopiert Eigenschaften des Effekts in die Effektinstanz.
Effect
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
 InheritedWird ausgelöst, wenn die Wiedergabe einer der Effektinstanzen beendet wurde, da die Instanz das Ende erreicht hatte oder da der Effekt durch den Aufruf der end()-Methode unterbrochen wurde.Effect
 InheritedWird ausgelöst, wenn der Effekt eine neue Wiederholung beginnt, und zwar für jeden Effekt, der mehr als einmal wiederholt wird.Animate
 InheritedWird ausgelöst, wenn die Wiedergabe eines Effekts gestartet wird.Effect
 InheritedWird ausgelöst, wenn der Effekt angehalten wurde. Dies geschieht nur, wenn der Effekt durch Aufrufen der stop()-Methode unterbrochen wird.Effect
 InheritedWird jedes Mal ausgelöst, wenn der Effekt das Ziel aktualisiert.Animate
Eigenschaftendetails

xBy

Eigenschaft
public var xBy:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Anzahl an Pixeln, um die die x-Position des Ziels zu ändern ist. Die Werte können negativ sein.

xFrom

Eigenschaft 
public var xFrom:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Ursprüngliche x-Position des Ziels in Pixeln. Wenn ausgelassen, verwendet Flex entweder den Wert im Startstatus der Ansicht, wenn der Effekt in einem Übergang abgespielt wird, oder den aktuellen Wert des Ziels.

xTo

Eigenschaft 
public var xTo:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Abschließende x-Position in Pixeln. Wenn ausgelassen, verwendet Flex entweder den Wert im Startstatus, wenn der Effekt in einem Statusübergang abgespielt wird, oder den aktuellen Wert des Ziels.

yBy

Eigenschaft 
public var yBy:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Anzahl an Pixeln, um die die y-Position des Ziels zu ändern ist. Werte können negativ sein.

yFrom

Eigenschaft 
public var yFrom:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Ursprüngliche y-Position des Ziels in Pixeln. Wenn ausgelassen, verwendet Flex entweder den Wert im Startstatus der Ansicht, wenn der Effekt in einem Übergang abgespielt wird, oder den aktuellen Wert des Ziels.

yTo

Eigenschaft 
public var yTo:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Abschließende y-Position des Ziels in Pixeln. Wenn ausgelassen, verwendet Flex entweder den Wert im Endstatus der Ansicht, wenn der Effekt in einem Übergang abgespielt wird, oder den aktuellen Wert des Ziels.

zBy

Eigenschaft 
public var zBy:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Anzahl der Pixel, um die die z-Position des Ziels geändert werden soll. Die Werte können negativ sein.

zFrom

Eigenschaft 
public var zFrom:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Ursprüngliche z-Position des Ziels. Wenn ausgelassen, verwendet Flex entweder den Wert im Startstatus der Ansicht, wenn der Effekt in einem Übergang abgespielt wird, oder den aktuellen Wert des Ziels.

zTo

Eigenschaft 
public var zTo:Number

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Abschließende z-Position des Ziels. Wenn ausgelassen, verwendet Flex entweder den Wert im Startstatus, wenn der Effekt in einem Statusübergang abgespielt wird, oder den aktuellen Wert des Ziels.

Konstruktordetails

Move3D

()Konstruktor
public function Move3D(target:Object = null)

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Konstruktor.

Parameter
target:Object (default = null) — Das Objekt, das mit diesem Effekt animiert wird.
Move3DEffectExample.mxml
<?xml version="1.0"?>
<!-- Simple example to demonstrate the s:Move3D class. -->
<s:Application
    xmlns:fx="http://ns.adobe.com/mxml/2009"
    xmlns:mx="library://ns.adobe.com/flex/mx"
    xmlns:s="library://ns.adobe.com/flex/spark">

    <fx:Declarations>
        <s:Move3D id="moveEffect" target="{targetBox}" xBy="100" zBy="100"
            repeatCount="2" repeatBehavior="reverse" 
            effectStart="playButton.enabled=false" effectEnd="playButton.enabled=true;"/>
    </fx:Declarations>

    <s:Panel title="Move3D Effect Example"
        width="75%" height="75%" >

        <mx:HBox width="100%" height="100%">
            <!-- Our target to affect-->
            <mx:VBox id="targetBox" width="50%"  horizontalAlign="center">
                <mx:Label text="Nokia 9930" />
                <mx:Image id="targetImg" source="@Embed(source='assets/Nokia_6630.png')"/>
            </mx:VBox>
            <mx:VBox id="detailsBox" width="50%" left="0">
                <mx:Text width="99%" color="blue"
                    text="The Move3D effect changes the location of a target using the following parameters: xFrom, xTo, xBy, yFrom, xTo, yBy. Click 'Move3D' to watch the effect."/>
            </mx:VBox>
        </mx:HBox>

        <s:Rect left="0" right="0" bottom="0" height="30">
            <s:fill>
                <s:LinearGradient rotation="90">
                    <s:GradientEntry color="0xE2E2E2" />
                    <s:GradientEntry color="0xD9D9D9" />
                </s:LinearGradient>
            </s:fill>
        </s:Rect>
        <s:Button id="playButton"
            left="5" bottom="5"
            label="Move3D" click="moveEffect.play();"/>
    </s:Panel>
</s:Application>




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