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

SeriesZoom  - AS3 Flex

Paketmx.charts.effects
Klassepublic class SeriesZoom
VererbungSeriesZoom Inheritance SeriesEffect Inheritance TweenEffect Inheritance Effect Inheritance EventDispatcher Inheritance Object

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

Der SeriesZoom-Effekt implodiert und explodiert Diagrammdaten zum und vom angegeben Fokuspunkt. Ob durch den SeriesSlide-Effekt eine Vergrößerung oder Verkleinerung von diesem Punkt durchgeführt wird, hängt davon ab, ob der Effekt dem Effekt-Trigger showDataEffect oder hideDataEffect zugewiesen ist.

MXML-SyntaxexpandedMXML-Syntax ausblenden

The <mx:SeriesZoom> tag inherits all the properties of its parent classes, and adds the following properties:

  <mx:SeriesZoom
    Properties
    horizontalFocus="center|left|right|null"
    relativeTo="series|chart"
    verticalFocus="top|center|bottom|null"
  />
  

Beispiele anzeigen



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 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
 Inheritedduration : Number
Dauer des Effekts in Millisekunden.
Effect
 InheritedeasingFunction : Function = null
Die Beschleunigungsfunktion für die Animation.
TweenEffect
 InheritedeffectTargetHost : mx.effects:IEffectTargetHost
Eine Eigenschaft, die Ihnen den Zugriff auf listenbasierte Zielsteuerelemente eines Dateneffekts ermöglicht.
Effect
 InheritedelementOffset : Number = 20
Gibt die Zeit (in Millisekunden) an, die Flex den Beginn des Effekts auf jedem Element in der Serie verzögert.
SeriesEffect
 Inheritedfilter : String
Gibt einen Algorithmus zum Filtern der Ziele für einen Effekt an.
Effect
 InheritedhideFocusRing : Boolean
Bestimmt, ob der Effekt den Fokusring beim Start ausblenden soll.
Effect
  horizontalFocus : String
Definiert die Position des Fokuspunkts des Zooms.
SeriesZoom
 InheritedinstanceClass : Class
Ein Objekt der type-Klasse, das die Effektinstanzklasse für diese Effektklasse angibt.
Effect
 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
 InheritedminimumElementDuration : Number = 0
Gibt die Zeitdauer (in Millisekunden) an, die ein einzelnes Element für die Durchführung des Effekts benötigt.
SeriesEffect
 Inheritedoffset : Number = 0
Gibt den Zeitraum (in Millisekunden) an, um den Flex den Effekt verzögert.
SeriesEffect
 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
  relativeTo : String = "series"
Steuert den Begrenzungsrahmen, den Flex zur Berechnung des Fokuspunkts der Vergrößerungen bzw. Verkleinerungen verwendet.
SeriesZoom
 InheritedrelevantProperties : Array
Ein Array von Eigenschaftsnamen zur Verwendung beim Filtern.
Effect
 InheritedrelevantStyles : Array
Ein Array von Stilnamen zur Verwendung beim Filtern.
Effect
 InheritedrepeatCount : int = 1
Ein Wert, der angibt, wie oft der Effekt wiederholt werden soll.
Effect
 InheritedrepeatDelay : int = 0
Wartezeit in Millisekunden vor der Wiederholung des Effekts.
Effect
 InheritedstartDelay : int = 0
Wartezeit in Millisekunden vor dem Starten des Effekts.
Effect
 InheritedsuspendBackgroundProcessing : Boolean = false
Bei „true“ erfolgt keine Hintergrundverarbeitung, während der Effekt wiedergegeben wird.
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
 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
 Inheritedtype : String = "show"
Der Typ des Übergangs, für den dieser Effekt verwendet wird.
SeriesEffect
  verticalFocus : String
Definiert die Position des Fokuspunkts des Zooms.
SeriesZoom
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
  
SeriesZoom(target:Object = null)
Konstruktor.
SeriesZoom
 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
 Inherited
Wird aufgerufen, wenn der TweenEffect ein TweenEvent auslöst.
TweenEffect
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 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 ausgelöst, wenn der Tweeneffekt endet.TweenEffect
 InheritedWird beim Start des Tweeneffekts ausgelöst. Dies entspricht dem ersten Aufruf der onTweenUpdate()-Methode.TweenEffect
 InheritedWird jedes Mal ausgelöst, wenn der Tweeneffekt das Ziel aktualisiert.TweenEffect
Eigenschaftendetails

horizontalFocus

Eigenschaft
public var horizontalFocus:String

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

Definiert die Position des Fokuspunkts des Zooms.

Gültige Werte der Eigenschaft horizontalFocus sind "left", "center", "right" und null.

Sie kombinieren die Eigenschaften horizontalFocus und verticalFocus, um festzulegen, an welchen Stellen die Datenserie eine Vergrößerung und Verkleinerung durchführt. Setzen Sie beispielsweise die Eigenschaft horizontalFocus auf "left" und die Eigenschaft verticalFocus auf "top", um die Seriendaten von der linken oberen Ecke des Elements oder Diagramms aus (je nach Einstellung der Eigenschaft relativeTo) zu vergrößern oder zu verkleinern.

Wenn Sie nur eine dieser zwei Eigenschaften angeben, liegt der Fokus auf einer horizontalen oder vertikalen Linie und nicht auf einem Punkt. Wenn Sie beispielsweise horizontalFocus auf "left", aber verticalFocus auf null setzen, wird das Element an einer vertikalen Linie entlang der linken Ecke des Begrenzungsrahmens vergrößert bzw. verkleinert. Setzen Sie die Eigenschaft verticalFocus auf "center", um Diagrammelemente an einer horizontalen Linie entlang der Mitte des Begrenzungsrahmens des Diagramms zu vergrößern bzw. zu verkleinern.

Der Standardwert ist "center".

relativeTo

Eigenschaft 
public var relativeTo:String = "series"

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

Steuert den Begrenzungsrahmen, den Flex zur Berechnung des Fokuspunkts der Vergrößerungen bzw. Verkleinerungen verwendet.

Gültige Werte für die Eigenschaft relativeTo sind "series" und "chart".

Verwenden Sie "series", um jedes Element relativ zu sich selbst zu vergrößern bzw. zu verkleinern. Beispielsweise kann jede Säule eines Säulendiagramms ausgehend von der linken oberen Ecke der Säule, der Säulenmitte usw. vergrößert oder verkleinert werden.

Verwenden Sie "chart", um jedes Element relativ zum Diagrammbereich zu zoomen. Beispielsweise kann jede Säule ausgehend von links oben der Achsen, der Achsenmitte usw. vergrößert oder verkleinert werden.

Der Standardwert ist "series".

verticalFocus

Eigenschaft 
public var verticalFocus:String

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

Definiert die Position des Fokuspunkts des Zooms. Weitere Informationen finden Sie in der Beschreibung der Eigenschaft horizontalFocus.

Gültige Werte von verticalFocus sind "top", "center", "bottom" und null.

Der Standardwert ist "center".

Konstruktordetails

SeriesZoom

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

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

Konstruktor.

Parameter
target:Object (default = null) — Das Ziel des Effekts.
SeriesZoomExample.mxml
<?xml version="1.0"?>
<!-- Simple example to demonstrate the CandlestickChart control. -->
<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 mx.collections.ArrayCollection;

        [Bindable]
        private var companyAAC:ArrayCollection = new ArrayCollection( [
            { Date: "25-Jul", Open: 40.75,  High: 40.75, Low: 40.24, Close:40.31},
            { Date: "26-Jul", Open: 39.98,  High: 40.78, Low: 39.97, Close:40.34},
            { Date: "27-Jul", Open: 40.38,  High: 40.66, Low: 40, Close:40.63},
            { Date: "28-Jul", Open: 40.49,  High: 40.99, Low: 40.3, Close:40.98},
            { Date: "29-Jul", Open: 40.13,  High: 40.4, Low: 39.65, Close:39.95},
            { Date: "1-Aug", Open: 39.00,  High: 39.50, Low: 38.7, Close:38.6}, 
            { Date: "2-Aug", Open: 38.68,  High: 39.34, Low: 37.75, Close:38.84}, 
            { Date: "3-Aug", Open: 38.76,  High: 38.76, Low: 38.03, Close:38.12}, 
            { Date: "4-Aug", Open: 37.98,  High: 37.98, Low: 36.56, Close:36.69},                       
            { Date: "5-Aug", Open: 36.61,  High: 37, Low: 36.48, Close:36.86} ]);

        [Bindable]
        private var companyBAC:ArrayCollection = new ArrayCollection( [
            { Date: "25-Jul", Open: 18.50,  High: 19, Low: 18.48, Close:18.86},
            { Date: "26-Jul", Open: 19.56,  High: 19.98, Low: 18.6, Close:18.69},                       
            { Date: "27-Jul", Open: 20.81,  High: 20.99, Low: 20.03, Close:20.12}, 
            { Date: "28-Jul", Open: 20.70,  High: 21.00, Low: 19.5, Close:20.84}, 
            { Date: "29-Jul", Open: 21.7,  High: 21.79, Low: 20.45, Close:20.6}, 
            { Date: "1-Aug", Open: 22.45,  High: 22.65, Low: 21.65, Close:21.95},
            { Date: "2-Aug", Open: 22.56,  High: 22.6, Low: 22.05, Close:22.98},
            { Date: "3-Aug", Open: 22.42,  High: 22.70, Low: 22.1, Close:22.63},
            { Date: "4-Aug", Open: 21.67,  High: 22.82, Low: 21.67, Close:22.34},
            { Date: "5-Aug", Open: 22.44,  High: 22.85, Low: 22.12, Close:22.31} ]);
        ]]>
    </fx:Script>
    
    <fx:Declarations>
        <mx:SeriesZoom id="zoomIn" duration="1000"/>
        <mx:SeriesZoom id="zoomOut" duration="1000"/>
    </fx:Declarations>

    <mx:Panel title="CandlestickChart Control Example" height="100%" width="100%" 
        paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">

        <mx:CandlestickChart id="candlestickchart" height="100%" width="100%"
            paddingRight="5" paddingLeft="5" 
            showDataTips="true" dataProvider="{companyAAC}">
            
            <mx:verticalAxis>
                <mx:LinearAxis id="vaxis" baseAtZero="false" title="Price"/>
            </mx:verticalAxis>

            <mx:horizontalAxis>
                <mx:CategoryAxis id="haxis" categoryField="Date" title="Date"/>
            </mx:horizontalAxis>

            <mx:horizontalAxisRenderers>
                <mx:AxisRenderer axis="{haxis}" canDropLabels="true"/>
            </mx:horizontalAxisRenderers>

            <mx:series>
                <mx:CandlestickSeries  
                    openField="Open" highField="High" 
                    lowField="Low" closeField="Close"
                    showDataEffect="{zoomIn}" 
                    hideDataEffect="{zoomOut}"/>
            </mx:series>
        </mx:CandlestickChart>
        
        <mx:Label width="100%" color="blue"
            text="Choose a company to view recent stock data."/>

        <mx:HBox>
            <mx:RadioButton groupName="stocks" label="View Company A"
                selected="true" click="candlestickchart.dataProvider=companyAAC;"/>
            <mx:RadioButton groupName="stocks" label="View Company B"
                click="candlestickchart.dataProvider=companyBAC;"/>
        </mx:HBox>
    </mx: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.