| Paket | mx.charts |
| Klasse | public class DateTimeAxis |
| Vererbung | DateTimeAxis  NumericAxis AxisBase EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
DateTimeAxis untersucht den Bereich zwischen Mindest- und Höchstwerten auf der Achse und bestimmt die Einheiten, die am besten zum Markieren der Achse geeignet sind. Die Achse wählt die höchste Einheit, durch die eine angemessene Anzahl von Beschriftungen für den angegebenen Bereich generiert wird. Sie können die vom Diagramm berücksichtigten Einheiten beschränken oder die zu verwendenden Einheiten genau angeben, indem Sie die Eigenschaft labelUnits verwenden.
Sie können die Mindest- und Höchstwerte explizit angeben oder automatisch von der Achse durch Untersuchung der gerenderte Werte im Diagramm bestimmen lassen. Standardmäßig wählt DateTimeAxis den kleinstmöglichen Bereich, der alle im Diagramm dargestellten Werte enthält. Optional können Sie festlegen, dass die Mindest- und Höchstwerte auf ganze Einheiten (Millisekunden, Sekunden, Minuten, Stunden, Tage, Wochen, Monate, Jahre) gerundet werden, indem Sie die Eigenschaft autoAdjust auf true setzen.
Sie können Wochentage und Datumsbereiche deaktivieren, um nur Arbeitstage auf der Achse und nicht alle Tage zwischen Mindest- und Höchstwert anzuzeigen. Sie können Daten auch filtern und nur die Daten, die Arbeitstagen entsprechen, im Diagramm anzeigen.
MXML-Syntax
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <mx:DateTimeAxis> tag inherits all the properties
of its parent classes and adds the following properties:
<mx:DateTimeAxis
Properties
alignLabelsToUnits="true|false"
dataUnits="milliseconds|seconds|minutes|hours|days|weeks|months|years"
disabledDays="Array; No default"
disabledRanges="Array; No default"
displayLocalTime="false"
interval="Number"
labelUnits="milliseconds|seconds|minutes|hours|days|weeks|months|years"
maximum="Date"
minimum="Date"
minorTickInterval="Number"
minorTickUnits="milliseconds|seconds|minutes|hours|days|weeks|months|years"
/>
Verwandte API-Elemente
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| alignLabelsToUnits : Boolean
Bestimmt die Platzierung der Beschriftungen entlang der Achse. | DateTimeAxis | ||
 | autoAdjust : Boolean
Gibt an, ob Flex Werte rundet. | NumericAxis | |
| baseAtZero : Boolean
Gibt an, ob Flex versucht, die Verankerung der Werte „minimum“ und „maximum“ bei null beizubehalten. | NumericAxis | |
| baseline : Number [schreibgeschützt]
Der berechnete Mindestwert für die Achse, wobei dieser Wert größer als 0 sein muss. | NumericAxis | |
| chartDataProvider : Object [Nur Schreiben]
Der dem umschließenden Diagramm zugewiesene Datenprovider. | AxisBase | |
| computedMaximum : Number
Der durch diese Achse dargestellte berechnete Höchstwert. | NumericAxis | |
| computedMinimum : Number
Der durch diese Achse dargestellte berechnete Mindestwert. | NumericAxis | |
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| dataInterval : Number [Nur Schreiben]
Legt das Intervall zwischen den Daten im Diagramm fest, das in dataUnits angegeben wird. | DateTimeAxis | ||
| dataUnits : String
Gibt die Einheiten an, die im Diagramm dargestellt werden sollen. | DateTimeAxis | ||
| direction : String
Bestimmt die Richtung, in die die Achse gerendert wird. | NumericAxis | |
| disabledDays : Array
Die Tage der Woche, die deaktiviert werden sollen. | DateTimeAxis | ||
| disabledRanges : Array
Deaktiviert einzelne und mehrere Tage. | DateTimeAxis | ||
| displayLocalTime : Boolean
Wenn „true“ festgelegt wird, geht DateTimeAxis davon aus, dass alle Datumswerte in der Zeitzone des Client-Rechners liegen, auf dem die Anwendung ausgeführt wird. | DateTimeAxis | ||
| displayName : String
Der Name der Achse. | AxisBase | |
| interval : Number
Gibt die Anzahl der labelUnits zwischen den Beschriftungswerten entlang der Achse an. | DateTimeAxis | ||
| labelFunction : Function
Wird zum Formatieren von Achsenwerten zur Anzeige als Beschriftungen aufgerufen. | NumericAxis | |
| labelUnits : String
Die Einheiten, die von der Achse zum Generieren der Beschriftungen verwendet werden. | DateTimeAxis | ||
| maximum : Date
Gibt den Höchstwert für eine Achsenbeschriftung an. | DateTimeAxis | ||
| minimum : Date
Gibt den Mindestwert für eine Achsenbeschriftung an. | DateTimeAxis | ||
| minorTickInterval : Number
Gibt die Anzahl der minorTickUnits zwischen den kleineren Markierungen entlang der Achse an. | DateTimeAxis | ||
| minorTicks : Array [schreibgeschützt]
Ein Array von kleineren Markierungen, der zur Darstellung dieser Achse generiert wurde. | NumericAxis | |
| minorTickUnits : String
Die Einheiten, die von der Achse beim Generieren kleinerer Markierungen berücksichtigt werden. | DateTimeAxis | ||
| padding : Number
Legt die Zellauffüllung fest, die Flex dem berechneten Mindest- und Höchstwert für die Achse beim Rendern der Werte auf dem Bildschirm hinzufügt. | NumericAxis | |
| parseFunction : Function [override]
Gibt eine Methode an, die den Wert von Datenpunkten anpasst. | DateTimeAxis | ||
| title : String
Der Text für den entlang der Achse angezeigten Titel. | AxisBase | |
| unitSize : Number [override] [schreibgeschützt]
Die Breite der einzelnen Dateneinheit in Pixeln. | DateTimeAxis | ||
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| assignedMaximum : Number
Der explizit zugewiesene Höchstwert. | NumericAxis | |
| assignedMinimum : Number
Der explizit zugewiesene Mindestwert. | NumericAxis | |
| computedInterval : Number
Das durch diese Achse dargestellte berechnete Intervall. | NumericAxis | |
| dataDescriptions : Array [schreibgeschützt]
Ein Array von DataDescription-Strukturen, die die durch das Diagramm dargestellten Daten beschreiben. | NumericAxis | |
| labelCache : Array
Der neueste Satz von AxisLabel-Objekten, die zur Darstellung dieser Achse generiert wurden. | NumericAxis | |
| labelMaximum : Number
Der Höchstwert für die Position von Beschriftungen. | NumericAxis | |
| labelMinimum : Number
Der Mindestwert für die Position von Beschriftungen. | NumericAxis | |
| minorTickCache : Array
Der neueste Satz von kleineren Markierungen, die zur Darstellung dieser Achse generiert wurden. | NumericAxis | |
| requiredDescribedFields : uint [override] [schreibgeschützt]
Die Felder der DescribeData-Struktur, an denen diese Achse interessiert ist. | DateTimeAxis | ||
| ticks : Array [schreibgeschützt]
Ein Array von Markierungen für diese Achse. | NumericAxis | |
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | DateTimeAxis | ||
| 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 | |
|
Löst Ereignisse aus, die das Bereichsobjekt informieren, wenn sich die Diagrammdaten geändert haben. | AxisBase | |
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
[override]
Filtert aus einem Satz von Werten beliebigen Typs einen Satz von Zahlen heraus, die zugeordnet werden können. | DateTimeAxis | ||
|
Formatiert Werte für die Anzeige in DataTips. | NumericAxis | |
|
Bestimmt den Bereich, um die Achsenbeschriftungen zu schätzen. | NumericAxis | |
|
Ruft den gerenderten Beschriftungstext ab. | NumericAxis | |
|
Ü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 | |
|
Ordnet eine Position entlang der Achse wieder einem numerischen Datenwert zu. | NumericAxis | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Konvertiert einen Satz von Werten beliebigen Typs in einen Satz von Zahlen, die in Bildschirmkoordinaten transformiert werden können. | NumericAxis | |
|
Bestimmt, wie die Achse sich überschneidende Beschriftungen verarbeitet. | NumericAxis | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
[override]
Aufgerufen, wenn ein AxisRenderer die Beschriftungen ohne Überschneidungen nicht sauber rendern kann und eine Reduzierung des Beschriftungssatzes durch das Achsenobjekt benötigt. | DateTimeAxis | ||
|
Jedes DataTransform, das eine Achse nutzt, registriert sich bei dieser Achse. | AxisBase | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
[override]
Ordnet einen Satz von Werten aus dem Datenraum Werten aus dem Bildschirmraum zu. | DateTimeAxis | ||
|
Jedes DataTransform, das eine Achse nutzt, registriert sich bei dieser Achse. | AxisBase | |
|
Aktualisiert das Diagramm. | NumericAxis | |
|
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 | |
| Methode | Definiert von | ||
|---|---|---|---|
|
Passt den generierten oder zugewiesenen Bereich der Achsenbeschriftungen an. | NumericAxis | |
|
Füllt die Eigenschaft „labelCache“ mit Beschriftungen, die die aktuellen Werte der Achse darstellen. | NumericAxis | |
[override]
Erstellt ein Array von Positionen für die kleineren Markierungen. Das Array wird durch diese Achse generiert. | DateTimeAxis | ||
|
Wird durch das steuernde DataTransform aufgerufen, um eine Beschreibung der durch dieses IChartElement dargestellten Daten zu erhalten. | AxisBase | |
Die Standardformatierungsfunktion, die verwendet wird, wenn auf der Achse auf Tagen basierende labelUnits angezeigt werden. | DateTimeAxis | ||
Die Standardformatierungsfunktion, die verwendet wird, wenn auf der Achse auf Millisekunden basierende labelUnits angezeigt werden. | DateTimeAxis | ||
Die Standardformatierungsfunktion, die verwendet wird, wenn auf der Achse auf Minuten basierende labelUnits angezeigt werden. | DateTimeAxis | ||
Die Standardformatierungsfunktion, die verwendet wird, wenn auf der Achse auf Monaten basierende labelUnits angezeigt werden. | DateTimeAxis | ||
Die Standardformatierungsfunktion, die verwendet wird, wenn auf der Achse auf Sekunden basierende labelUnits angezeigt werden. | DateTimeAxis | ||
Die Standardformatierungsfunktion, die verwendet wird, wenn auf der Achse auf Jahren basierende labelUnits angezeigt werden. | DateTimeAxis | ||
|
Schützt den Bereich gegen ungültige Werte für diesen Achsentyp. | NumericAxis | |
|
Macht die Beschriftungen und Markierungen im Cache, die die Werte dieser Achse darstellen, ungültig. | NumericAxis | |
alignLabelsToUnits | Eigenschaft |
alignLabelsToUnits:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Bestimmt die Platzierung der Beschriftungen entlang der Achse.
Bei false platziert das Diagramm immer eine Beschriftung an den Anfang der Achse. Beispiel: Wenn bei einer Beschriftung für jeden Monat der erste Datenpunkt der 14. Juli ist, wird die erste Beschriftung beim 14. Juli eingefügt. Bei true berechnet Flex zuerst die Beschriftungseinheiten, und beschriftet dann das erste ganze Intervall dieser Einheiten. Beispiel: Wenn der erste Datenpunkt der 14. Juli ist und die Beschriftungseinheiten Monate sind (explizit festgelegt oder dynamisch berechnet), wird die erste Beschriftung beim 1. August angezeigt.
Der Standardwert ist true.
Implementierung
public function get alignLabelsToUnits():Boolean public function set alignLabelsToUnits(value:Boolean):voiddataInterval | Eigenschaft |
dataInterval:Number [Nur Schreiben] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Legt das Intervall zwischen den Daten im Diagramm fest, das in dataUnits angegeben wird.
Wenn die Eigenschaft dataUnits auf "hours" und die Eigenschaft dataInterval auf 4 gesetzt ist, geht das Diagramm davon aus, dass die Daten alle vier Stunden auftreten. Dies wirkt sich bei einigen Serien (wie ColumnSeries und CandlestickSeries) auf das Rendern der Daten aus. Es beeinflusst auch die automatische Auswahl von Beschriftungen.
Implementierung
public function set dataInterval(value:Number):voidVerwandte API-Elemente
dataUnits | Eigenschaft |
dataUnits:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt die Einheiten an, die im Diagramm dargestellt werden sollen. Folgende Werte sind möglich:
millisecondssecondsminuteshoursdaysweeksmonthsyears
Dieser Wert wird auf zwei Arten verwendet. Erstens wählt DateTimeAxis keine Beschriftungseinheiten aus, die kleiner als die durch die Daten dargestellten Einheiten sind. Wenn die Eigenschaft dataUnits den Wert days hat, zeigt das Diagramm keine Beschriftungen für Stunden an, unabhängig vom Bereich der Mindest- und Höchstwerte.
Zweitens beeinflusst die Eigenschaft dataUnits das Rendern einiger Serien. Insbesondere wenn Säulenserien (wie ColumnSeries, BarSeries, CandlestickSeries und HLOCSeries) dargestellt werden, wird die gerenderte Säulenbreite mithilfe der Eigenschaft dataUnits bestimmt.
Beispiel: Im ColumnChart-Steuerelement sind die Eigenschaften der horizontalen Achse wie folgt gesetzt: labelUnits auf weeks und dataUnits auf days. In diesem Fall rendert ColumnCharts jede Säule entsprechend dem siebten Teil des Abstands zwischen den Beschriftungen.
Wenn die Eigenschaft dataUnits auf null gesetzt wird, werden die Säulen der Säulenserien als Tage gerendert, DateTimeAxis wählt jedoch beim Generieren der Beschriftungen eine geeignete Einheit aus.
Der Standardwert ist null.
Implementierung
public function get dataUnits():String public function set dataUnits(value:String):voiddisabledDays | Eigenschaft |
disabledDays:Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Tage innerhalb einer Woche, die zu deaktivieren sind. Alle Datumswerte eines Monats für den entsprechenden Tag werden deaktiviert. Die Elemente dieses Arrays können Werte zwischen 0 (Sonntag) und 6(Samstag) haben. So deaktiviert beispielsweise ein Wert von [ 0, 6 ] den Sonntag und Samstag.
Implementierung
public function get disabledDays():Array public function set disabledDays(value:Array):voiddisabledRanges | Eigenschaft |
disabledRanges:Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Deaktiviert einzelne und mehrere Tage.
Diese Eigenschaft akzeptiert ein Array von Objekten als Parameter. Jedes Objekt in diesem Array muss ein Date-Objekt sein, das den zu deaktivierenden einzelnen Tag angibt, oder ein Objekt, das eine oder beide der Eigenschaften rangeStart oder rangeEnd enthält. Die Werte dieser beiden Eigenschaften sind Date-Objekte. Der Wert dieser Eigenschaften beschreibt die Grenzen des Datumsbereichs. Wenn eine der beiden Eigenschaften fehlt, setzt sich der Bereich unbegrenzt in die entsprechende Richtung fort. Wenn Sie lediglich rangeStart festlegen, werden alle Daten nach dem festgelegten Datum deaktiviert inklusive desrangeStart-Datums. Wenn Sie lediglich rangeEnd festlegen, werden alle Daten vor diesem Tag deaktiviert inklusive des rangeEnd-Datums. Um einen einzelnen Tag zu deaktivieren, verwenden Sie ein einzelnes Date-Objekt, das ein Datum im Array angibt.
Im folgenden Beispiel werden diese Datumswerte deaktiviert: 11. Januar 2006, der Zeitraum vom 23. Januar bis zum 10. Februar 2006 und alle folgenden Datumswerte.
disabledRanges="{[ new Date(2006,0,11), {rangeStart: new Date(2006,0,23), rangeEnd: new Date(2006,1,10)}, {rangeStart: new Date(2006,2,1)} ]}"
Der Standardwert ist [].
Implementierung
public function get disabledRanges():Array public function set disabledRanges(value:Array):voiddisplayLocalTime | Eigenschaft |
displayLocalTime:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wenn true festgelegt wird, geht DateTimeAxis davon aus, dass alle Datumswerte in der Zeitzone des Client-Rechners liegen, auf dem die Anwendung ausgeführt wird. Bei false wird davon ausgegangen, dass alle Werte in Weltzeit (GMT) angegeben sind.
Implementierung
public function get displayLocalTime():Boolean public function set displayLocalTime(value:Boolean):voidinterval | Eigenschaft |
interval:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt die Anzahl der labelUnits zwischen den Beschriftungswerten entlang der Achse an. Flex berechnet das Intervall, wenn diese Eigenschaft auf null gesetzt ist.
Der Standardwert ist null.
Implementierung
public function get interval():Number public function set interval(value:Number):voidlabelUnits | Eigenschaft |
labelUnits:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Einheiten, die von der Achse zum Generieren der Beschriftungen verwendet werden. Standardmäßig berücksichtigt DateTimeAxis alle gültigen Einheiten (Millisekunden, Sekunden, Minuten, Stunden, Tage, Wochen, Monate oder Jahre).
Wenn die Eigenschaft labelUnits nicht festgelegt ist, verwendet das Diagramm keine Einheiten, die kleiner als der Wert der Eigenschaft dataUnits sind, um Beschriftungen zu rendern.
Implementierung
public function get labelUnits():String public function set labelUnits(value:String):voidmaximum | Eigenschaft |
maximum:Date| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt den Höchstwert für eine Achsenbeschriftung an. Bei null bestimmt Flex den Mindestwert anhand der Daten im Diagramm.
Der Standardwert ist null.
Implementierung
public function get maximum():Date public function set maximum(value:Date):voidminimum | Eigenschaft |
minimum:Date| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt den Mindestwert für eine Achsenbeschriftung an. Bei null bestimmt Flex den Mindestwert anhand der Daten im Diagramm.
Der Standardwert ist null.
Implementierung
public function get minimum():Date public function set minimum(value:Date):voidminorTickInterval | Eigenschaft |
minorTickInterval:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt die Anzahl der minorTickUnits zwischen den kleineren Markierungen entlang der Achse an. Wenn dies auf NaN gesetzt ist, berechnet DateTimeAxis den Wert automatisch.
Normalerweise wird die Eigenschaft minorTickInterval automatisch auf 1 gesetzt. Wenn die Einheit der Eigenschaft minorTickUnits jedoch derjenigen der Eigenschaft dataUnits entspricht (explizit festgelegt oder implizit berechnet), entspricht die Eigenschaft minorTickInterval dem Höchstwert 1 oder dataInterval.
Implementierung
public function get minorTickInterval():Number public function set minorTickInterval(value:Number):voidminorTickUnits | Eigenschaft |
minorTickUnits:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Einheiten, die von der Achse beim Generieren kleinerer Markierungen berücksichtigt werden. Standardmäßig berücksichtigt DateTimeAxis alle gültigen Einheiten (Millisekunden, Sekunden, Minuten, Stunden, Tage, Wochen, Monate oder Jahre).
Wenn diese Eigenschaft nicht festgelegt ist, bestimmt das Diagramm den Wert der Eigenschaft minorTickUnits. Wenn das Beschriftungsintervall größer als 1 ist, wird die Eigenschaft minorTickUnits auf den Wert der Eigenschaft labelUnits gesetzt und die Eigenschaft minorTickInterval auf 1 gesetzt. Wenn das Beschriftungsintervall 1 entspricht, wird die Eigenschaft minorTickUnits auf die nächste kleinere Einheit der Eigenschaft labelUnits gesetzt. Wenn die Eigenschaft minorTickUnits festgelegt ist, kann sie nicht unter dem Wert der Eigenschaft dataUnits liegen.
Implementierung
public function get minorTickUnits():String public function set minorTickUnits(value:String):voidparseFunction | Eigenschaft |
parseFunction:Function[override] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt eine Methode an, die den Wert von Datenpunkten anpasst. Mit dieser Eigenschaft geben Sie eine Methode an, die einen Wert akzeptiert und ein Date-Objekt zurückgibt. Das Date-Objekt wird im DateTimeAxis-Objekt des Diagramms verwendet. Dies ermöglicht Ihnen anpassbare Dateneingabestrings bereitzustellen und in Date-Objekte zu konvertieren, die Flex für die Verwendung in DateTimeAxis interpretieren kann.
Flex übergibt nur einen Parameter an die Parsingmethode. Dieser Parameter ist der Wert des Datenpunkts, den Sie für die Serie angegeben haben. Üblicherweise handelt es sich um einen String, der eine Datumsform darstellt. Sie können diesen Parameter nicht überschreiben und auch keine zusätzlichen Parameter hinzufügen.
Dieses Date-Objekt wird unmittelbar in einen numerischen Wert umgewandelt, sodass angepasste Parsingfunktionen dasselbe Date-Objekt wiederverwenden können. Standardmäßig verwendet DateTimeAxis die String-Parsingfunktion der ECMA-Standardmethode Date.parse().
parseFunction angegebene Methode nutzt diese Werte zum Erstellen eines Date-Objekts, das von der Achse verwendet werden kann.
<mx:Script>
import mx.collections.ArrayCollection;
[Bindable]
public var aapl:ArrayCollection = new ArrayCollection([
{date: "2005, 8, 1", close: 42.71},
{date: "2005, 8, 2", close: 42.99},
{date: "2005, 8, 3", close: 44}
]);
public function myParseFunction(s:String):Date {
// Get an array of Strings from the comma-separated String passed in.
var a:Array = s.split(",");
// Create the new Date object. Note that the month argument is 0-based (with 0 being January).
var newDate:Date = new Date(a[0],a[1]-1,a[2]);
return newDate;
}
</mx:Script>
<mx:LineChart id="mychart" dataProvider="{aapl}" showDataTips="true">
<mx:horizontalAxis>
<mx:DateTimeAxis dataUnits="days" parseFunction="myParseFunction"/>
</mx:horizontalAxis>
<mx:series>
<mx:LineSeries yField="close" xField="date" displayName="AAPL"/>
</mx:series>
</mx:LineChart>
Implementierung
override public function get parseFunction():Function override public function set parseFunction(value:Function):voidrequiredDescribedFields | Eigenschaft |
requiredDescribedFields:uint [schreibgeschützt] [override] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Felder der DescribeData-Struktur, an denen diese Achse interessiert ist.
Implementierung
override protected function get requiredDescribedFields():uintunitSize | Eigenschaft |
unitSize:Number [schreibgeschützt] [override] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Breite der einzelnen Dateneinheit in Pixeln. Der Typ der Dateneinheit wird durch den Wert der Eigenschaft dataUnits bestimmt.
Implementierung
override public function get unitSize():NumberDateTimeAxis | () | Konstruktor |
public function DateTimeAxis()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Konstruktor.
buildMinorTickCache | () | Methode |
override protected function buildMinorTickCache():Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Erstellt ein Array von Positionen für die kleineren Markierungen. Das Array wird durch diese Achse generiert. Unterklassen müssen diese Funktion implementieren. Diese Funktion wird automatisch von NumericAxis aufgerufen. Sie sollten auf die Eigenschaft minorTicks zugreifen, statt diese Funktion direkt aufzurufen.
Array — Ein Array der Positionen von 0 bis 1, die die Punkte zwischen den Mindest- und Höchstwerten der Achse darstellen, an denen kleinere Markierungen angezeigt werden.
|
filterCache | () | Methode |
override public function filterCache(cache:Array, field:String, filteredField:String):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Filtert aus einem Satz von Werten beliebigen Typs einen Satz von Zahlen heraus, die zugeordnet werden können.
Parameter
cache:Array — Ein Array von Objekten zum Auslesen und Speichern von konvertierten Werten.
| |
field:String — Das Feld der Objekte im Cache-Array, das die vorgefilterten Werte enthält.
| |
filteredField:String — Das Feld der Objekte im Cache-Array, in dem die gefilterten Werte gespeichert werden sollten.
|
formatDays | () | Methode |
protected function formatDays(d:Date, previousValue:Date, axis:mx.charts:DateTimeAxis):String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Standardformatierungsfunktion, die verwendet wird, wenn auf der Achse auf Tagen basierende labelUnits angezeigt werden. Wenn Sie eine angepasste DateTimeAxis-Klasse schreiben, können Sie diese Methode überschreiben, um eine alternative Standardformatierung bereitzustellen.
Sie können diese Methode nicht direkt aufrufen. Stattdessen ruft Flex diese Methode vor dem Rendern der Beschriftung auf, um den entsprechenden darzustellenden String abzurufen.
Parameter
d:Date — Das Date-Objekt, das die zu formatierende Einheit enthält.
| |
previousValue:Date — Das Date-Objekt, das den Datenpunkt vor dem aktuellen Datenpunkt enthält.
| |
axis:mx.charts:DateTimeAxis — DateTimeAxis, auf der die Beschriftung angezeigt wird.
|
String — Die formatierte Beschriftung.
|
formatMilliseconds | () | Methode |
protected function formatMilliseconds(d:Date, previousValue:Date, axis:mx.charts:DateTimeAxis):String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Standardformatierungsfunktion, die verwendet wird, wenn auf der Achse auf Millisekunden basierende labelUnits angezeigt werden. Wenn Sie eine angepasste DateTimeAxis-Klasse schreiben, können Sie diese Methode überschreiben, um eine alternative Standardformatierung bereitzustellen.
Sie können diese Methode nicht direkt aufrufen. Stattdessen ruft Flex diese Methode vor dem Rendern der Beschriftung auf, um den entsprechenden darzustellenden String abzurufen.
Parameter
d:Date — Das Date-Objekt, das die zu formatierende Einheit enthält.
| |
previousValue:Date — Das Date-Objekt, das den Datenpunkt vor dem aktuellen Datenpunkt enthält.
| |
axis:mx.charts:DateTimeAxis — DateTimeAxis, auf der die Beschriftung angezeigt wird.
|
String — Die formatierte Beschriftung.
|
formatMinutes | () | Methode |
protected function formatMinutes(d:Date, previousValue:Date, axis:mx.charts:DateTimeAxis):String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Standardformatierungsfunktion, die verwendet wird, wenn auf der Achse auf Minuten basierende labelUnits angezeigt werden. Wenn Sie eine angepasste DateTimeAxis-Klasse schreiben, können Sie diese Methode überschreiben, um eine alternative Standardformatierung bereitzustellen.
Sie können diese Methode nicht direkt aufrufen. Stattdessen ruft Flex diese Methode vor dem Rendern der Beschriftung auf, um den entsprechenden darzustellenden String abzurufen.
Parameter
d:Date — Das Date-Objekt, das die zu formatierende Einheit enthält.
| |
previousValue:Date — Das Date-Objekt, das den Datenpunkt vor dem aktuellen Datenpunkt enthält.
| |
axis:mx.charts:DateTimeAxis — DateTimeAxis, auf der die Beschriftung angezeigt wird.
|
String — Die formatierte Beschriftung.
|
formatMonths | () | Methode |
protected function formatMonths(d:Date, previousValue:Date, axis:mx.charts:DateTimeAxis):String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Standardformatierungsfunktion, die verwendet wird, wenn auf der Achse auf Monaten basierende labelUnits angezeigt werden. Wenn Sie eine angepasste DateTimeAxis-Klasse schreiben, können Sie diese Methode überschreiben, um eine alternative Standardformatierung bereitzustellen.
Sie können diese Methode nicht direkt aufrufen. Stattdessen ruft Flex diese Methode vor dem Rendern der Beschriftung auf, um den entsprechenden darzustellenden String abzurufen.
Parameter
d:Date — Das Date-Objekt, das die zu formatierende Einheit enthält.
| |
previousValue:Date — Das Date-Objekt, das den Datenpunkt vor dem aktuellen Datenpunkt enthält.
| |
axis:mx.charts:DateTimeAxis — DateTimeAxis, auf der die Beschriftung angezeigt wird.
|
String — Die formatierte Beschriftung.
|
formatSeconds | () | Methode |
protected function formatSeconds(d:Date, previousValue:Date, axis:mx.charts:DateTimeAxis):String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Standardformatierungsfunktion, die verwendet wird, wenn auf der Achse auf Sekunden basierende labelUnits angezeigt werden. Wenn Sie eine angepasste DateTimeAxis-Klasse schreiben, können Sie diese Methode überschreiben, um eine alternative Standardformatierung bereitzustellen.
Sie können diese Methode nicht direkt aufrufen. Stattdessen ruft Flex diese Methode vor dem Rendern der Beschriftung auf, um den entsprechenden darzustellenden String abzurufen.
Parameter
d:Date — Das Date-Objekt, das die zu formatierende Einheit enthält.
| |
previousValue:Date — Das Date-Objekt, das den Datenpunkt vor dem aktuellen Datenpunkt enthält.
| |
axis:mx.charts:DateTimeAxis — DateTimeAxis, auf der die Beschriftung angezeigt wird.
|
String — Die formatierte Beschriftung.
|
formatYears | () | Methode |
protected function formatYears(d:Date, previousValue:Date, axis:mx.charts:DateTimeAxis):String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Die Standardformatierungsfunktion, die verwendet wird, wenn auf der Achse auf Jahren basierende labelUnits angezeigt werden. Wenn Sie eine angepasste DateTimeAxis-Klasse schreiben, können Sie diese Methode überschreiben, um eine alternative Standardformatierung bereitzustellen.
Sie können diese Methode nicht direkt aufrufen. Stattdessen ruft Flex diese Methode vor dem Rendern der Beschriftung auf, um den entsprechenden darzustellenden String abzurufen.
Parameter
d:Date — Das Date-Objekt, das die zu formatierende Einheit enthält.
| |
previousValue:Date — Das Date-Objekt, das den Datenpunkt vor dem aktuellen Datenpunkt enthält.
| |
axis:mx.charts:DateTimeAxis — DateTimeAxis, auf der die Beschriftung angezeigt wird.
|
String — Die formatierte Beschriftung.
|
reduceLabels | () | Methode |
override public function reduceLabels(intervalStart:AxisLabel, intervalEnd:AxisLabel):AxisLabelSet| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Aufgerufen, wenn ein AxisRenderer die Beschriftungen ohne Überschneidungen nicht sauber rendern kann und eine Reduzierung des Beschriftungssatzes durch das Achsenobjekt benötigt. An die Methode werden zwei sich überschneidende Beschriftungen übergeben.
Parameter
intervalStart:AxisLabel — Der Anfang des Intervalls, in dem sich Beschriftungen überschneiden.
| |
intervalEnd:AxisLabel — Das Ende des Intervalls, in dem sich Beschriftungen überschneiden.
|
AxisLabelSet — Eine neuer Beschriftungssatz, durch den das Problem der Überschneidung behoben wird, indem die Anzahl der Beschriftungen reduziert wird.
|
transformCache | () | Methode |
override public function transformCache(cache:Array, field:String, convertedField:String):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ordnet einen Satz von Werten aus dem Datenraum Werten aus dem Bildschirmraum zu.
Parameter
cache:Array — Ein Array von Objekten zum Auslesen und Speichern von zugeordneten Werten.
| |
field:String — Das Feld der Objekte im Cache-Array, das die vorzugeordneten Werte enthält.
| |
convertedField:String — Das Feld der Objekte im Cache-Array, in dem die zugeordneten Werte gespeichert werden sollten.
|
<?xml version="1.0"?>
<!-- Simple example to demonstrate the DateTimeAxis 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">
<fx:Script>
<![CDATA[
import mx.collections.ArrayCollection;
[Bindable]
public var stockDataAC:ArrayCollection = new ArrayCollection( [
{date: "2005, 7, 27", close: 41.71},
{date: "2005, 7, 28", close: 42.21},
{date: "2005, 7, 29", close: 42.11},
{date: "2005, 8, 1", close: 42.71},
{date: "2005, 8, 2", close: 42.99},
{date: "2005, 8, 3", close: 44} ]);
public function myParseFunction(s:String):Date {
// Get an array of Strings from the comma-separated String passed in.
var a:Array = s.split(",");
// Create the new Date object. Subtract one from
// the month property because months are zero-based in
// the Date constructor.
var newDate:Date = new Date(a[0],a[1]-1,a[2]);
return newDate;
}
]]>
</fx:Script>
<mx:Panel title="DateTimeAxis Example" height="100%" width="100%">
<mx:LineChart id="mychart" height="100%" width="100%"
paddingRight="5" paddingLeft="5"
showDataTips="true" dataProvider="{stockDataAC}">
<mx:horizontalAxis>
<mx:DateTimeAxis dataUnits="days" parseFunction="myParseFunction"/>
</mx:horizontalAxis>
<mx:verticalAxis>
<mx:LinearAxis baseAtZero="false" />
</mx:verticalAxis>
<mx:series>
<mx:LineSeries yField="close" xField="date" displayName="AAPL"/>
</mx:series>
</mx:LineChart>
</mx:Panel>
</s:Application>
Tue Jun 12 2018, 10:04 AM Z