ViewTransitionBase

Paket	spark.transitions
Klasse	public class ViewTransitionBase
Vererbung	ViewTransitionBase EventDispatcher Object
Unterklassen	CrossFadeViewTransition, FlipViewTransition, SlideViewTransition, ZoomViewTransition

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Die ViewTransitionBase-Klasse ist die Basisklasse für alle Ansichtsübergänge. Sie sollte nicht als eigenständiger Übergang verwendet werden. Zusätzlich zur Benutzerfreundlichkeit und zur Bereitstellung von Helper-Methoden bei den Ansichtsübergängen bietet diese Klasse auch eine Standardübergangssequenz für die Aktionsleiste.

Wenn ein Ansichtsübergang initialisiert wurde, legt der besitzende Ansichtsnavigator die startView- und endView-Eigenschaften für die Ansichten fest, die der Übergang animiert. Die navigator-Eigenschaft wird auf den Ansichtsnavigator gesetzt.

Der Zyklus eines Übergangs sieht folgendermaßen aus:

Der Übergang beginnt mit der captureStartValues()-Methode. Wenn diese Methode aufgerufen wird, befindet sich der Navigator aktuell im Anfangsstatus. Zu diesem Zeitpunkt sollte der Übergang alle benötigten Startwerte und Bitmaps erfassen.
Ein Überprüfungsdurchlauf wird für die ausstehende Ansicht ausgeführt und die captureEndValues()-Methode wird aufgerufen. Zu diesem Zeitpunkt erfasst der Übergang alle Eigenschaften oder Bitmap-Darstellungen aus der anstehenden Ansicht.
Dann wird die prepareForPlay()-Methode aufgerufen, wodurch der Übergang alle weiteren Vorbereitungen (z. B. eine Spark-Effektreihenfolge vorbereiten oder vorübergehende Elemente in der Anzeigeliste platzieren) ausführen kann.
Nach einem letzten Überprüfungsdurchlauf (falls erforderlich) ruft der Navigator die play()-Methode auf, um den eigentlichen Übergang auszuführen.
Vor Beginn einer Animation wird jeweils das start-Ereignis ausgelöst.
Nach Abschluss eines Übergangs wird ein end-Ereignis ausgelöst.

Hinweis: Erstellen und konfigurieren Sie Ansichtsübergänge in ActionScript. In MXML ist dies nicht möglich.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		duration : Number Dauer des Übergangs in Millisekunden.	ViewTransitionBase
		easer : IEaser Das Beschleunigungsverhalten für diesen Übergang.	ViewTransitionBase
		endView : View Die Ansicht, für die der Navigator den Übergang ausführt, wie sie vom besitzenden ViewNavigator-Objekt festgelegt wird.	ViewTransitionBase
		navigator : ViewNavigator Verweis auf die besitzende ViewNavigator-Instanz, die vom besitzenden ViewNavigator festgelegt wird.	ViewTransitionBase
		startView : View Die aktuell aktive Ansicht des Ansichtsnavigators, wie sie vom besitzenden Ansichtsnavigators festgelegt wird.	ViewTransitionBase
		suspendBackgroundProcessing : Boolean Ist sie auf „true“ gesetzt, wird die UIComponent.suspendBackgroundProcessing()-Methode aufgerufen, bevor der Übergang abgespielt wird.	ViewTransitionBase
		transitionControlsWithContent : Boolean Ist sie auf „true“ gesetzt, wird der Übergang des Ansichtsnavigators mit dem primären Ansichtsübergang vollständig ausgeführt, auch der der Aktionsleiste.	ViewTransitionBase

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		ViewTransitionBase() Konstruktor.	ViewTransitionBase
		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
		captureEndValues():void Wird vom ViewNavigator während der Vorbereitungsphase eines Übergangs aufgerufen.	ViewTransitionBase
		captureStartValues():void Wird vom ViewNavigator während der Vorbereitungsphase eines Übergangs aufgerufen.	ViewTransitionBase
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		play():void Wird vom ViewNavigator aufgerufen, wenn der Übergang mit der Animation beginnen soll.	ViewTransitionBase
		prepareForPlay():void Wird vom ViewNavigator während der Vorbereitungsphase eines Übergangs aufgerufen.	ViewTransitionBase
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Ü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

	Methode		Definiert von
		canTransitionControlBarContent():Boolean Bestimmt, ob Flex einen Übergang für den Inhalt der Aktions- oder Registerkartenleiste unabhängig von den Ansichten ausführen kann.	ViewTransitionBase
		cleanUp():void Wird aufgerufen, nachdem der Übergang abgeschlossen ist.	ViewTransitionBase
		createActionBarEffect():IEffect Durch diese, von der Standardimplementierung „prepareForPlay()“ aufgerufene Methode wird der Spark-Effekt erzeugt, der zu Beginn des Übergangs in der Aktionsleiste wiedergegeben wird.	ViewTransitionBase
		createConsolidatedEffect():IEffect Durch diese, von der Standardimplementierung „prepareForPlay()“ aufgerufene Methode wird der Spark-Effekt erzeugt, der abgespielt wird, um erforderlichenfalls den Übergang des kompletten Navigators (einschließlich des Inhalts der Steuerleiste) auszuführen.	ViewTransitionBase
		createTabBarEffect():IEffect Durch diese, von der Standardimplementierung „prepareForPlay()“ aufgerufene Methode wird der Spark-Effekt erzeugt, der zu Beginn des Übergangs in der Registerkartenleiste wiedergegeben wird.	ViewTransitionBase
		createViewEffect():IEffect Durch diese, von der Standardimplementierung „prepareForPlay()“ aufgerufene Methode wird der Spark-Effekt erzeugt, der zu Beginn des Übergangs in der aktuellen und der nächsten Ansicht wiedergegeben wird.	ViewTransitionBase
		getSnapshot(target:UIComponent, padding:int = 4, globalPosition:Point = null):BitmapImage Wird verwendet, um Schnappschüsse von Bildschirmelementen in Vorbereitung auf den Übergang zu rendern.	ViewTransitionBase
		transitionComplete():void Wird vom Übergang aufgerufen, um anzugeben, dass der Übergang abgeschlossen wurde.	ViewTransitionBase

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
transitionEnd	Wird ausgelöst, wenn der Übergang abgeschlossen ist.	ViewTransitionBase
transitionStart	Wird ausgelöst, wenn der Übergang beginnt.	ViewTransitionBase

Eigenschaftendetails

duration

Eigenschaft

duration:Number

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Dauer des Übergangs in Millisekunden. Der Standardwert hängt vom jeweiligen Übergang ab, ist aber in ViewTransitionBase als 250 ms definiert.

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

easer

Eigenschaft

easer:IEaser

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Das Beschleunigungsverhalten für diesen Übergang. Im Allgemeinen wird das IEaser-Objekt an die IEffect-Instanz weitergegeben, die die eigentliche Übergangsanimation verwaltet.

Der Standardwert ist Sine(.5);.

Implementierung
public function get easer():IEaser
public function set easer(value:IEaser):void

Verwandte API-Elemente

spark.effects.easing

endView

Eigenschaft

endView:View

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Die Ansicht, für die der Navigator den Übergang ausführt, wie sie vom besitzenden ViewNavigator-Objekt festgelegt wird. Diese Eigenschaft kann den Wert „Null“ haben.

Der Standardwert ist null.

Implementierung
public function get endView():View
public function set endView(value:View):void

navigator

Eigenschaft

navigator:ViewNavigator

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Verweis auf die besitzende ViewNavigator-Instanz, die vom besitzenden ViewNavigator festgelegt wird.

Der Standardwert ist null.

Implementierung
public function get navigator():ViewNavigator
public function set navigator(value:ViewNavigator):void

startView

Eigenschaft

startView:View

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Die aktuell aktive Ansicht des Ansichtsnavigators, wie sie vom besitzenden Ansichtsnavigators festgelegt wird. Diese Eigenschaft kann den Wert „Null“ haben.

Implementierung
public function get startView():View
public function set startView(value:View):void

suspendBackgroundProcessing

Eigenschaft

suspendBackgroundProcessing:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Ist sie auf true gesetzt, wird die UIComponent.suspendBackgroundProcessing()-Methode aufgerufen, bevor der Übergang abgespielt wird. Damit wird der Layoutmanager von Flex deaktiviert und die Leistung verbessert. Nach Abschluss des Übergangs wird die Layoutmanagerfunktion wiederhergestellt, indem die UIComponent.resumeBackgroundProcessing()-Methode aufgerufen wird.

Der Standardwert ist false.

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

Verwandte API-Elemente

mx.core.UIComponent.suspendBackgroundProcessing()
mx.core.UIComponent.resumeBackgroundProcessing()

transitionControlsWithContent

Eigenschaft

transitionControlsWithContent:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Ist sie auf true gesetzt, wird der Übergang des Ansichtsnavigators mit dem primären Ansichtsübergang vollständig ausgeführt, auch der der Aktionsleiste. Spezifische Übergänge für die Aktionsleiste werden nicht ausgeführt. Da die Registerkartenleiste mit der gesamten Anwendung und nicht mit einer Ansicht verknüpft ist, haben Ansichtsübergänge keine Wirkung.

Auch wenn sie auf false gesetzt ist, gibt es Fälle, in denen es nicht möglich ist, einen Übergang für die Aktionsleiste zu erstellen. Beispielsweise wenn die Aktionsleiste in einer der beiden Ansichten nicht vorhanden ist oder sich ihre Größe ändert.

Der Standardwert ist false.

Implementierung
public function get transitionControlsWithContent():Boolean
public function set transitionControlsWithContent(value:Boolean):void

Konstruktordetails

()

Konstruktor

public function ViewTransitionBase()

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Konstruktor.

Methodendetails

canTransitionControlBarContent

()

Methode

protected function canTransitionControlBarContent():Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Bestimmt, ob Flex einen Übergang für den Inhalt der Aktions- oder Registerkartenleiste unabhängig von den Ansichten ausführen kann.

Flex kann in den folgenden Fällen einen Übergang für die Steuerleisten nicht unabhängig durchführen:

Wenn der Ansichtsnavigator ein TabbedViewNavigator ist und sich die Sichtbarkeit seiner Registerkartenleiste zwischen Ansichten ändern.
Wenn sich der Wert der overlayControls-Eigenschaft des Ansichtnavigators zwischen den Ansichten ändert.
Wenn sich die Größe oder Sichtbarkeit der Aktionsleiste zwischen den Ansichten ändert.

Rückgabewerte

Boolean — false, wenn Flex festlegt, dass die Steuerleisten zwischen den Ansichten inkompatibel sind.

captureEndValues

()

Methode

public function captureEndValues():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Wird vom ViewNavigator während der Vorbereitungsphase eines Übergangs aufgerufen. Sie wird aufgerufen, wenn die neue Ansicht vollständig realisiert und überprüft ist und der Inhalt der Aktionsleiste und der Registerkartenleiste dem Status der neuen Ansicht entspricht. An dieser Stelle kann der Übergang alle Werte der ausstehenden Ansicht erfassen, die erforderlich sind. Außerdem sollten alle Bitmaps erfasst werden, die den neuen Ansichts-, Registerkartenleisten- und Aktionsleistenstatus widerspiegeln, wenn sie für die Animation erforderlich sind.

captureStartValues

()

Methode

public function captureStartValues():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

()

Methode

protected function getSnapshot(target:UIComponent, padding:int = 4, globalPosition:Point = null):BitmapImage

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Wird verwendet, um Schnappschüsse von Bildschirmelementen in Vorbereitung auf den Übergang zu rendern. Die Bitmap wird in Form eines BitmapImage-Objekts zurückgegeben.

Das BitmapImage ist im übergeordneten Koordinatenraum des Ziels. Es überlappt das Ziel genau, wenn es demselben übergeordneten Element übergeordnet ist. Vergewissern Sie sich, dass Sie beim Wechseln zu einem anderen übergeordneten Element die Transformation des BitmapImage anpassen, um die Änderung im Koordinatenraum korrekt zu berücksichtigen. Der aktualisierte Wert des globalPosition-Parameters kann dafür verwendet werden.

Parameter

	`target:UIComponent` — Zu erfassendes Anzeigeobjekt.

	`padding:int` (default = `4`) — Auffüllung um das Objekt, die in das BitmapImage-Objekt eingeschlossen werden soll.

	`globalPosition:Point` (default = `null`) — Wenn nicht null, wird `globalPosition` mit dem Ursprung des BitmapImage in globalen Koordinaten aktualisiert. Beim Wechseln zu einem anderen Koordinatenraum wird dieser Wert zum Anpassen der Schnappschussposition verwendet. Die globale Bildschirmposition ändert sich nicht.

Rückgabewerte

BitmapImage — BitmapImage-Objekt, das das Ziel darstellt.

play

()

Methode

public function play():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Wird vom ViewNavigator aufgerufen, wenn der Übergang mit der Animation beginnen soll. Zu diesem Zeitpunkt sollte der Übergang ein start-Ereignis auslösen.

prepareForPlay

()

Methode

public function prepareForPlay():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Wird vom ViewNavigator während der Vorbereitungsphase eines Übergangs aufgerufen. Dadurch kann vom Übergang die zugrunde liegende IEffect-Instanz erstellt und konfiguriert werden oder vorübergehende Elemente können zur Anzeigeliste hinzugefügt werden. Beispiele für vorübergehende Elemente sind Bitmap-Platzhalter, während des Übergangs erforderliche temporäre Container und andere. Falls erforderlich, wird eine letzte Überprüfung vor dem Aufruf der play()-Methode durchgeführt.

Wenn festgelegt ist, dass ein Standardübergang eingeleitet werden kann (z. B. dass der Übergang der Steuerleisten getrennt von den Ansichten ausgeführt wird), erzeugt die Standardimplementierung dieser Methode einen einzelnen Paralleleffekt, der die Reihenfolgen der individuellen Effekte für den Ansichtsübergang, den Aktionsleistenübergang und den Registerkartenleistenübergang einschließt. Diese Methode nutzt die Methoden createActionBarEffect(), createTabBarEffect() und createViewEffect().

Wenn transitionControlsWithContent auf true gesetzt wurde oder bestimmt wurde, dass für die Steuerleisten kein unabhängiger Übergang ausgeführt werden kann, wird ein einzelner Effekt erstellt, mit dem der komplette Übergang des Navigators ausgeführt wird. In diesem Fall wird nur createConsolidatedEffect() aufgerufen.

transitionComplete

()

Methode

protected function transitionComplete():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Wird vom Übergang aufgerufen, um anzugeben, dass der Übergang abgeschlossen wurde. Diese Methode löst das end-Ereignis aus.

Ereignisdetails

transitionEnd

Ereignis

Ereignisobjekttyp: mx.events.FlexEvent
Eigenschaft FlexEvent.type = mx.events.FlexEvent.TRANSITION_START

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Wird ausgelöst, wenn der Übergang abgeschlossen ist.

Die FlexEvent.TRANSITION_START-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein transitionStart-Ereignis.

Dieses Ereignis wird nur ausgelöst, wenn an das auslösende Objekt ein oder mehr entsprechende Listener angehängt sind.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`cancelable`	false
`currentTarget`	Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise `myButton.addEventListener()` zur Registrierung eines Ereignis-Listeners verwenden, weist `currentTarget` den Wert „myButton“ auf.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die `currentTarget`-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

transitionStart

Ereignis

Ereignisobjekttyp: mx.events.FlexEvent
Eigenschaft FlexEvent.type = mx.events.FlexEvent.TRANSITION_START

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4.5

Laufzeitversionen:

AIR 2.5

Wird ausgelöst, wenn der Übergang beginnt.

Die FlexEvent.TRANSITION_START-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein transitionStart-Ereignis.

Dieses Ereignis wird nur ausgelöst, wenn an das auslösende Objekt ein oder mehr entsprechende Listener angehängt sind.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`cancelable`	false
`currentTarget`	Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise `myButton.addEventListener()` zur Registrierung eines Ereignis-Listeners verwenden, weist `currentTarget` den Wert „myButton“ auf.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die `currentTarget`-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

Rechtliche Hinweise | Onlinedatenschutzerklärung

ViewTransitionBase - AS3 Flex

Klassen x

duration

easer

endView

navigator

startView

suspendBackgroundProcessing

transitionControlsWithContent