| Paket | mx.effects |
| Klasse | public class Zoom |
| Vererbung | Zoom  TweenEffect Effect EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
 | Beginnend mit Flex 4.0 empfiehlt Adobe die Verwendung der Klasse spark.effects.Scale als Alternative zu dieser Klasse. |
Beim Zoomeffekt wird ein Objekt von einem Mittelpunkt aus vergrößert und verkleinert.
Wenn Sie einen Zoomeffekt auf Text anwenden, der mit einer Systemschriftart gerendert wird, skaliert Flex den Text zwischen ganzen Punktgrößen. Eingebettete Schriftarten sind zwar keine Voraussetzung für die Anwendung eines Zoomeffekts, jedoch wirkt der Effekt dadurch gleichmäßiger.
Hinweis: Der Zoomeffekt funktioniert nicht, wenn die Container.autoLayout-Eigenschaft auf false gesetzt ist.
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <mx:Zoom> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:Zoom
id="ID"
captureRollEvents="false|true"
originX="Calculated"
originY="Calculated"
zoomWidthFrom="0.01"
zoomWidthTo="1.0"
zoomHeightFrom="0.01"
zoomHeightTo="1.0"
/>
Verwandte API-Elemente
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| captureRollEvents : Boolean
Bei „true“ löst Flex nur rollOut- und rollOver-Ereignisse aus, wenn die Maus bewegt wurde. | Zoom | ||
 | className : String [schreibgeschützt]
Name der Effektklasse wie „Fade“. | Effect | |
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| customFilter : mx.effects:EffectTargetFilter
Gibt ein benutzerdefiniertes Filterobjekt des Typs EffectTargetFilter an, das zur Ermittlung der Ziele dient, bei denen der Effekt wiedergegeben wird. | Effect | |
| duration : Number
Dauer des Effekts in Millisekunden. | Effect | |
| easingFunction : Function = null
Die Beschleunigungsfunktion für die Animation. | TweenEffect | |
| effectTargetHost : mx.effects:IEffectTargetHost
Eine Eigenschaft, die Ihnen den Zugriff auf listenbasierte Zielsteuerelemente eines Dateneffekts ermöglicht. | Effect | |
| filter : String
Gibt einen Algorithmus zum Filtern der Ziele für einen Effekt an. | Effect | |
| hideFocusRing : Boolean
Bestimmt, ob der Effekt den Fokusring beim Start ausblenden soll. | Effect | |
| instanceClass : Class
Ein Objekt der type-Klasse, das die Effektinstanzklasse für diese Effektklasse angibt. | Effect | |
| isPlaying : 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 | |
| originX : Number
Wert für die x-Position des Zoomursprungs, wenn das Effektziel sich in einem Container befindet, der absolute Positionen unterstützt, wie etwa der Arbeitsflächencontainer. | Zoom | ||
| originY : Number
Wert für die y-Position des Zoomursprungs, wenn das Effektziel sich in einem Container befindet, der absolute Positionen unterstützt, wie etwa der Arbeitsflächencontainer. | Zoom | ||
| perElementOffset : Number
Zusätzliche Verzögerung (in Millisekunden) für Effektziele nach dem ersten Ziel des Effekts. | Effect | |
| playheadTime : Number
Aktuelle Zeitposition des Effekts. | Effect | |
| relevantProperties : Array
Ein Array von Eigenschaftsnamen zur Verwendung beim Filtern. | Effect | |
| relevantStyles : Array
Ein Array von Stilnamen zur Verwendung beim Filtern. | Effect | |
| repeatCount : int = 1
Ein Wert, der angibt, wie oft der Effekt wiederholt werden soll. | Effect | |
| repeatDelay : int = 0
Wartezeit in Millisekunden vor der Wiederholung des Effekts. | Effect | |
| startDelay : int = 0
Wartezeit in Millisekunden vor dem Starten des Effekts. | Effect | |
| suspendBackgroundProcessing : Boolean = false
Bei „true“ erfolgt keine Hintergrundverarbeitung, während der Effekt wiedergegeben wird. | Effect | |
| target : Object
Das Objekt, auf das dieser Effekt angewendet wird. | Effect | |
| targets : Array
Ein Array von Objekten, die als Ziele des Effekts verwendet werden können. | Effect | |
| triggerEvent : 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 | |
| zoomHeightFrom : Number
Anfangswert zum Zoomen der Höhe (Prozentwert zwischen 0,01 und 1,0). | Zoom | ||
| zoomHeightTo : Number
Endwert zum Zoomen der Höhe (Prozentwert zwischen 0.01 und 1.0). | Zoom | ||
| zoomWidthFrom : Number
Anfangswert zum Zoomen der Breite (Prozentwert zwischen 0.01 und 1.0). | Zoom | ||
| zoomWidthTo : Number
Endwert zum Zoomen der Breite (Prozentwert zwischen 0.01 und 1.0). | Zoom | ||
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | Zoom | ||
| 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 | |
|
Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts und speichert sie als Endwerte. | Effect | |
|
Erfasst die aktuellen Werte der relevanten Eigenschaften eines zusätzlichen Zielsatzes. Flex verwendet diese Funktion, wenn ein Datenänderungseffekt ausgeführt wird.
| Effect | |
|
Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts. | Effect | |
|
Erstellt eine einzelne Effektinstanz und initialisiert sie. | Effect | |
|
Verwendet ein Array von Zielobjekten und ruft die createInstance()-Methode auf jedem Ziel auf. | Effect | |
|
Entfernt Ereignis-Listener von einer Instanz und entfernt sie aus der Liste der Instanzen. | Effect | |
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
|
Unterbricht einen aktuell wiedergegebenen Effekt und springt sofort zum Ende des Effekts. | Effect | |
|
Gibt ein Array von Strings zurück, wobei jeder String dem Namen einer Eigenschaft entspricht, die von diesem Effekt geändert wird. | Effect | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Hält den Effekt an, bis die resume()-Methode aufgerufen wird. | Effect | |
|
Startet die Wiedergabe des Effekts. | Effect | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde. | Effect | |
|
Gibt den aktuell wiedergegebenen Effekt rückwärts wieder und beginnt dabei an der aktuellen Position des Effekts. | Effect | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Hält den Effekt an und behält den aktuellen Status der Effektziele bei. | Effect | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
captureRollEvents | Eigenschaft |
public var captureRollEvents:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Bei true löst Flex nur rollOut- und rollOver-Ereignisse aus, wenn die Maus bewegt wurde. Setzen Sie diese Eigenschaft auf true, wenn Sie den Zoomeffekt verwenden, um das Effektziel abwechselnd groß und klein anzuzeigen.
Sie lösen beispielsweise mit rollOverEffect den Zoomeffekt zum Verkleinern des Ziels aus. Bei Verkleinerung des Ziels befindet sich der Mauszeiger nicht mehr über dem Ziel, wodurch ein rollOut-Ereignis und der entsprechende rollOutEffect ausgelöst werden. Wenn Sie die captureRollEvents-Eigenschaft auf true setzen, löst Flex nur bei einer Mausbewegung ein rollOut-Ereignis aus.
Der Standardwert ist false.
originX | Eigenschaft |
public var originX:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wert für die x-Position des Zoomursprungs, wenn das Effektziel sich in einem Container befindet, der absolute Positionen unterstützt, wie etwa der Arbeitsflächencontainer. Der Zoomursprung ist die Position auf dem Ziel, die sich im Mittelpunkt des Zoomeffekts befindet.
Der Wert muss zwischen 0 und der Breite der Zielkomponente liegen.
Der Standardwert isttarget.width / 2, was dem Mittelpunkt des Ziels entspricht.
originY | Eigenschaft |
public var originY:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wert für die y-Position des Zoomursprungs, wenn das Effektziel sich in einem Container befindet, der absolute Positionen unterstützt, wie etwa der Arbeitsflächencontainer. Der Zoomursprung ist die Position auf dem Ziel, die sich im Mittelpunkt des Zoomeffekts befindet.
Der Wert muss zwischen 0 und der Höhe der Zielkomponente liegen.
Der Standardwert isttarget.height / 2, was dem Mittelpunkt des Ziels entspricht.
zoomHeightFrom | Eigenschaft |
public var zoomHeightFrom:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Anfangswert zum Zoomen der Höhe (Prozentwert zwischen 0,01 und 1,0). Der Standardwert ist 0,01, was einer sehr geringen Höhe entspricht.
zoomHeightTo | Eigenschaft |
public var zoomHeightTo:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Endwert zum Zoomen der Höhe (Prozentwert zwischen 1.0 und 0.01). Der Standardwert ist 1.0, was der normalen Objekthöhe entspricht.
zoomWidthFrom | Eigenschaft |
public var zoomWidthFrom:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Anfangswert zum Zoomen der Breite (Prozentwert zwischen 0,01 und 1,0). Der Standardwert ist 0,01, was einer sehr geringen Breite entspricht.
zoomWidthTo | Eigenschaft |
public var zoomWidthTo:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Endwert zum Zoomen der Breite (Prozentwert zwischen 1.0 und 0.01). Der Standardwert ist 1.0, was der normalen Objektbreite entspricht.
Zoom | () | Konstruktor |
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Zoom effect. -->
<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">
<fx:Script>
<![CDATA[
import flash.events.MouseEvent;
public function doZoom(event:MouseEvent):void {
if (zoomAll.isPlaying) {
zoomAll.reverse();
}
else {
// If this is a ROLL_OUT event, play the effect backwards.
// If this is a ROLL_OVER event, play the effect forwards.
zoomAll.play([event.target], event.type == MouseEvent.ROLL_OUT ? true : false);
}
}
]]>
</fx:Script>
<fx:Declarations>
<mx:Zoom id="zoomAll" zoomWidthTo="1" zoomHeightTo="1" zoomWidthFrom=".5" zoomHeightFrom=".5" />
</fx:Declarations>
<s:Panel title="Zoom Effect Example" width="95%" height="95%" >
<s:VGroup left="20" right="20" top="20" bottom="20">
<s:Label width="100%" color="blue"
text="Move the mouse over the image to enlarge it. Move the mouse off of the image to shrink it."/>
<mx:Image id="img"
source="@Embed(source='assets/Nokia_6630.png')"
scaleX=".5" scaleY=".5"
rollOver="doZoom(event)"
rollOut="doZoom(event)"/>
</s:VGroup>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 10:04 AM Z