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...
mx.states 

Transition  - AS3 Flex

Paketmx.states
Klassepublic class Transition
VererbungTransition Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die Transition-Klasse definiert einen Satz Effekte, die als Reaktion auf eine Änderung des Ansichtsstatus wiedergegeben werden. Während eine Ansichtsstatusdefinition festlegt, wie Status geändert werden, definiert ein Übergang die Reihenfolge der visuellen Änderungen während einer Statusänderung.

Um einen Übergang zu definieren, können Sie die transitions-Eigenschaft einer Anwendung auf ein Array von Transition-Objekten setzen.

Mit der toState- und der fromState-Eigenschaft der Transition-Klasse geben Sie die Statusänderungen an, die den Übergang auslösen. Standardmäßig ist sowohl die fromState- als auch die toState-Eigenschaft auf „*“ gesetzt, d. h. der Übergang wird auf jede beliebige Änderung des Ansichtsstatus angewendet.

Mit der fromState-Eigenschaft können Sie den Ausgangsansichtsstatus und mit der toState-Eigenschaft den Zielansichtsstatus explizit angeben. Wenn eine Statusänderung zwei Übergängen entspricht, hat die toState-Eigenschaft vor der fromState-Eigenschaft Priorität. Wenn mehrere Übergänge zutreffen, verwendet Flex die erste Definition im Übergangsarray.

Mit der effect-Eigenschaft geben Sie das Effect-Objekt an, das bei Anwendung eines Übergangs wiedergegeben wird. Normalerweise ist dies ein Composite-Effektobjekt (z. B. Parallel- oder Sequenz-Effekt), das mehrere Effekte enthält, wie das folgende Beispiel zeigt:

 
  <mx:Transition id="myTransition" fromState="*" toState="*">
    <mx:Parallel>
        ...
    </mx:Parallel>
  </mx:Transition>
  

MXML-SyntaxexpandedMXML-Syntax ausblenden

The <mx:Transition> tag defines the following attributes:

  <mx:Transition
    Properties
    id="ID"
    effect=""
    fromState="*"
    toState="*"
    autoReverse="false"
  />
  

Standard-MXML-Eigenschafteffect

Beispiele anzeigen

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  autoReverse : Boolean = false
Wird auf „true“ gesetzt, um festzulegen, dass dieser Übergang auf Änderungen des Ansichtsstatus sowohl für Vorwärts- als auch für Rückwärtsübergänge angewendet wird.
Transition
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  effect : IEffect
Das wiederzugebende IEffect-Objekt, wenn Sie den Übergang anwenden.
Transition
  fromState : String = "*"
Ein String, der den Ansichtsstatus angibt, aus dem Sie wechseln, wenn Sie den Übergang anwenden.
Transition
  interruptionBehavior : String = "end"
Flex unterstützt nicht die gleichzeitige Wiedergabe mehrerer Übergänge.
Transition
  toState : String = "*"
Ein String, der den Ansichtsstatus angibt, in den Sie wechseln, wenn Sie den Übergang anwenden.
Transition
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
Transition
 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
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
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
Eigenschaftendetails

autoReverse

Eigenschaft
public var autoReverse:Boolean = false

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Wird auf true gesetzt, um festzulegen, dass dieser Übergang auf Änderungen des Ansichtsstatus sowohl für Vorwärts- als auch Rückwärtsübergänge angewendet wird. Verwenden Sie daher diesen Übergang für eine Änderung des Ansichtsstatus A zu Ansichtsstatus B und umgekehrt.

Während der Übergang von Ansichtsstatus A zu Ansichtsstatus B wiedergegeben wird, kann der Rückwärtsübergang zur Unterbrechung des aktuellen Übergangs erfolgen. Der Rückwärtsübergang hält immer den aktuellen Übergang an der aktuellen Position an. D. h., der Rückwärtsübergang wird immer wiedergegeben, als ob für die interruptionBehavior-Eigenschaft stop festgelegt wurde, unabhängig vom eigentlichen Wert von interruptionBehavior.

Diese Eigenschaft wird nur aktiviert, wenn der neue Übergang in genau die entgegengesetzte Richtung des derzeit wiedergegebenen Effekts durchgeführt wird. D. h., dass bei der Wiedergabe eines Übergangs zwischen den Status A und B ein an A zurückzugebender Übergang gestartet wird.

Wenn ein Übergang die toState- und fromState-Eigenschaften zum expliziten Verarbeiten des Übergangs von Ansichtsstatus B zu A verwendet, ignoriert Flex die autoReverse-Eigenschaft.

Der Standardwert ist false.

Verwandte API-Elemente

effect

Eigenschaft 
public var effect:IEffect

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das wiederzugebende IEffect-Objekt, wenn Sie den Übergang anwenden. Normalerweise ist dies ein Composite-Effektobjekt(z. B. Parallel- oder Sequenz-Effekt), das mehrere Effekte enthält.

Die effect-Eigenschaft ist die Standardeigenschaft der Transition-Klasse. Sie können das <mx:effect>-Tag auslassen, wenn Sie den MXML-Tag-Syntax verwenden.

fromState

Eigenschaft 
public var fromState:String = "*"

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ein String, der den Ansichtsstatus angibt, aus dem Sie wechseln, wenn Sie den Übergang anwenden. Der Standardwert ist „*“, d. h. ein beliebiger Ansichtsstatus.

Sie können diese Eigenschaft auf einen leeren String („“) setzen, was dem Basisansichtsstatus entspricht.

Der Standardwert ist "*".

interruptionBehavior

Eigenschaft 
public var interruptionBehavior:String = "end"

Sprachversion: ActionScript 3.0
Produktversion: Flex 4.5
Laufzeitversionen: Flash Player 10.2, AIR 2.5

Flex unterstützt nicht die gleichzeitige Wiedergabe mehrerer Übergänge. Wenn beim Auftreten eines neuen Übergangs ein Übergang zurzeit wiedergegeben wird, wird der aktuelle Übergang unterbrochen. Diese Eigenschaft steuert, wie der aktuelle Übergang bei einer Unterbrechung reagiert.

Standardmäßig endet der aktuelle Übergang, was dazu führt, dass alle Effekte im Übergang zu ihren Endwerten springen. Dies entspricht dem Eigenschaftswert end. Wenn der Wert dieser Eigenschaft stop ist, wird der aktuelle Übergang an der aktuellen Position angehalten. Die Wiedergabe des neuen Übergangs wird ab der Position, an der der vorherige Übergang angehalten wurde, gestartet.

Der Wert stop kann einen unterbrochenen Übergang glatter darstellen. Daher sieht der Benutzer nicht, wie der aktuelle Übergang zu seinem Endstatus springt, bevor der neue Übergang beginnt.

In einigen Fällen kann der unterbrochene Übergang die Umkehrung des aktuellen Übergangs sein. Während beispielsweise der Übergang von Ansichtsstatus A zu Ansichtsstatus B wiedergegeben wird, erfolgt der Rückwärtsübergang zur Unterbrechung des aktuellen Übergangs. Wenn Sie für die autoReverse-Eigenschaft einer Übergangsinstanz true festlegen, können Sie denselben Übergang verwenden, um Vorwärts- und Rückwärtsübergänge zu verarbeiten. Wenn der unterbrechende Übergang der Rückwärtsübergang des aktuellen Übergangs ist und für diesen autoReverse auf true gesetzt ist, wird der unterbrechende Übergang ausgeführt, als ob für die interruptionBehavior-Eigenschaft stop festgelegt wurde, unabhängig vom eigentlichen Wert von interruptionBehavior.

Die mx.states.InterruptionBehavior-Klasse definiert die möglichen Werte für diese Eigenschaft.

Der Standardwert ist end.

Verwandte API-Elemente

toState

Eigenschaft 
public var toState:String = "*"

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ein String, der den Ansichtsstatus angibt, in den Sie wechseln, wenn Sie den Übergang anwenden. Der Standardwert ist „*“, d. h. ein beliebiger Ansichtsstatus.

Sie können diese Eigenschaft auf einen leeren String („“) setzen, was dem Basisansichtsstatus entspricht.

Der Standardwert ist "*".

Konstruktordetails

Transition

()Konstruktor
public function Transition()

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Konstruktor.

TransitionExample.mxml
<?xml version="1.0" ?>
<!-- Simple example to demonstrate the Transition class. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
    xmlns:s="library://ns.adobe.com/flex/spark"
    xmlns:mx="library://ns.adobe.com/flex/mx" currentState="Login">
 
    <!-- Define the view states -->
    <s:states>
        <s:State name="Login" />
        <s:State name="Register" />
    </s:states>

    <s:transitions>
        <!-- Define the transition from the base state to the Register state.-->
        <s:Transition id="toRegister" fromState="*" toState="Register">
            <s:Sequence targets="{[loginPanel, registerLink, confirm, loginLink]}">
                <s:RemoveAction />
                <s:Fade />
                <s:SetAction target="{loginPanel}" property="title" />
                <s:SetAction target="{loginButton}" property="label" />
                <s:SetAction target="{loginButton}" property="color" />
                <s:Resize target="{loginPanel}"/>
                <s:AddAction />
                <s:Fade />
            </s:Sequence>
        </s:Transition>

        <!-- Define the transition from the Register state to the base state.-->
        <s:Transition id="toDefault" fromState="Register" toState="*">
            <s:Sequence targets="{[loginPanel, registerLink, 
                    confirm, loginLink]}">
                <s:RemoveAction/>
                <s:SetAction target="{loginPanel}" property="title"/>
                <s:SetAction  target="{loginButton}" property="label"/>
                <s:SetAction target="{loginButton}" property="color"/>
                <s:Resize target="{loginPanel}"/>
                <s:AddAction/>
            </s:Sequence>
        </s:Transition>
    </s:transitions>

    <!-- Define a Panel container that defines the login form. The title of the Panel
         changes depending on the state. -->
    <s:Panel title="Login" title.Register="Register" id="loginPanel" 
            width="75%" horizontalCenter="0" verticalCenter="0">
    <s:controlBarLayout >
        <s:BasicLayout />
    </s:controlBarLayout>
    <s:layout>
        <s:VerticalLayout paddingTop="10" paddingBottom="10" paddingRight="10" paddingLeft="10" />
    </s:layout>
        <s:Label color="blue" width="100%"
            text="Click the 'Need to Register?' link to change state. Click the 'Return to Login' link to return to the base state."/>

        <!-- The following form has  two TextInputs in the Login state and three TextInputs
             in the Register state. -->
        <s:Form id="loginForm" >
            <s:FormItem label="Username:">
                <s:TextInput/>
            </s:FormItem>
            <s:FormItem label="Password:">
                <s:TextInput/>
            </s:FormItem>
            <s:FormItem id="confirm" label="Confirm:" includeIn="Register" includeInLayout="false" includeInLayout.Register="true">
                <s:TextInput/>
            </s:FormItem>
        </s:Form>
       
        <!-- The controlBar includes two visible items in each state. Which LinkButton is visible is determined
             by the state -->
        <s:controlBarContent>
            <mx:LinkButton id="registerLink"  label="Need to Register?" top="10" bottom="10"
                click="currentState='Register'" left="10" includeIn="Login" />
            <mx:LinkButton id="loginLink" label="Return to Login" click="currentState=''" includeIn="Register" left="10"  top="10" bottom="10"/>
            <s:Button label="Login" label.Register="Register" id="loginButton" right="10" color.Register="0x0000FF"  top="10" bottom="10"/>
        </s:controlBarContent>
    </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.