DateTimeAxis  - AS3 Flex

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.

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.

Verwandte API-Elemente

Gibt die Einheiten an, die im Diagramm dargestellt werden sollen. Folgende Werte sind möglich:

• milliseconds
• seconds
• minutes
• hours
• days
• weeks
• months
• years

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.

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.

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 [].

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.

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.

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.

Gibt den Höchstwert für eine Achsenbeschriftung an. Bei null bestimmt Flex den Mindestwert anhand der Daten im Diagramm.

Der Standardwert ist null.

Gibt den Mindestwert für eine Achsenbeschriftung an. Bei null bestimmt Flex den Mindestwert anhand der Daten im Diagramm.

Der Standardwert ist null.

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.

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.

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().

      <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>
      

Die Felder der DescribeData-Struktur, an denen diese Achse interessiert ist.

Die Breite der einzelnen Dateneinheit in Pixeln. Der Typ der Dateneinheit wird durch den Wert der Eigenschaft dataUnits bestimmt.

Konstruktor.

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.

Filtert aus einem Satz von Werten beliebigen Typs einen Satz von Zahlen heraus, die zugeordnet werden können.

Parameter

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

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

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

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

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

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

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

Ordnet einen Satz von Werten aus dem Datenraum Werten aus dem Bildschirmraum zu.

Parameter