Series  - AS3 Flex

Gibt eine Methode an, welche den Wert zurückgibt, der für die Platzierung des aktuellen Diagrammelements in der Serie verwendet werden soll. Ist die Eigenschaft konfiguriert, hat der Rückgabewert der benutzerdefinierten Datenfunktion Vorrang vor den anderen zugehörigen Eigenschaften, wie etwa xField und yField für „AreaSeries“, „BarSeries“, „BubbleSeries“, „ColumnSeries“, „LineSeries“ und „PlotSeries“. Bei „BubbleSeries“ hat der Rückgabewert Vorrang vor der Eigenschaft radiusField. Bei „PieSeries“ hat der Rückgabewert Vorrang vor der Eigenschaft field.

Die benutzerdefinierte dataFunction für eine Serie hat folgende Signatur:

     function_name (series:Series, item:Object, fieldName:String):Object { ... }
     

Normalerweise wird die Eigenschaft dataFunction für den Zugriff auf Felder in einem Datenprovider verwendet, die keine Skalarwerte aufweisen, sondern stattdessen verschachtelt im Datenprovider vorliegen. Beispielsweise erfordern die folgenden Daten eine Datenfunktion für den Zugriff auf die Felder für den Datenprovider eines Diagramms:

      {month: "Aug", close: {High:45.87,Low:12.2}, open:25.19}
      

Im folgenden Beispiel wird ein Wert von diesem Datenprovider zurückgegeben:

     public function myDataFunction(series:Series, item:Object, fieldName:String):Object {
          if (fieldName == 'yValue')
              return(item.close.High);
          else if (fieldName == "xValue")
              return(item.month);
          else
              return null;
     }     
     

Array von Diagrammelementen, für die Datentipps nicht interaktiv im Diagramm angezeigt werden sollen.

Das DataTransform-Objekt, mit dem das Element verknüpft ist. Ein DataTransform-Objekt repräsentiert eine Verknüpfung zwischen einem Satz von Elementen und einem Satz von Achsenobjekten, die zum Transformieren dieser Elemente von Datenraumwerten zu Bildschirmkoordinaten (und umgekehrt) verwendet werden. Ein Diagrammelement verwendet sein verknüpftes DataTransform-Objekt zur Berechnung, wie seine Daten gerendert werden sollen.

Der Name der Serie zur Anzeige für den Benutzer. Diese Eigenschaft wird zur Darstellung der Serie in für den Benutzer sichtbaren Beschriftungen verwendet, z. B. Datentipps.

Wenn filterFunction oder filterDataValues festgelegt ist, wird filterData ignoriert. true, wenn die Serie ihre Daten vor der Anzeige filtert. Wenn eine Serie Daten rendert, die fehlende Werte aufweist (wie etwa null, undefined, oder NaN), oder Werte rendert, die sich außerhalb des Bereichs der Diagrammachsen befinden, sollte diese Eigenschaft auf true (entspricht dem Standard) eingestellt werden. Wenn Sie wissen, dass alle Daten in der Serie gültig sind, können Sie diesen Wert zur Verbesserung der Leistung auf false einstellen.

Wenn filterFunction festgelegt ist, werden filterDataValues und filterData ignoriert. Wenn für die filterDataValues-Eigenschaft der Wert none festgelegt ist, filtert die Serie die zugehörigen Daten nicht vor der Anzeige. Wenn filterDataValues auf nulls gesetzt ist, filtert die Serie die Daten wie null, undefined oder NaN vor der Anzeige. Wenn für diese Eigenschaft der Wert outsideRange festgelegt ist, filtert die Serie die zugehörigen Daten wie null, undefined oder NaN sowie die Werte, die außerhalb des Bereichs der Diagrammachsen liegen. Wenn Sie wissen, dass alle Daten in der Serie gültig sind, können Sie diesen Wert zur Verbesserung der Leistung auf none einstellen.

Gibt eine Methode an, die den Array der anzuzeigenden Diagrammelemente der Serie zurückgibt. Wenn diese Eigenschaft festgelegt ist, hat der Rückgabewert der angepassten Filterfunktion Vorrang vor den Eigenschaften filterDataValues und filterData. Wenn allerdings „null“ zurückgegeben wird, werden filterDataValues und filterData in dieser Reihenfolge bevorzugt.

Die angepasste filterFunction hat die folgende Signatur:

     function_name (cache:Array):Array { ... }
     

     public function myFilterFunction(cache:Array):Array {
          var filteredCache:Array=[];
          var n:int = cache.length;  
          for(var i:int = 0; i < n; i++)
          {
              var item:ColumnSeriesItem = ColumnSeriesItem(cache[i]);
              if(item.yNumber > 0 && item.yNumber < 700)
              {
                  filteredCache.push(item);
              }
          }
          return filteredCache;
     }
     

Wenn Sie eine angepasste Filterfunktion für die Diagrammserie angeben und Null-Werte oder Werte außerhalb des Achsenbereichs filtern möchten, müssen Sie sie manuell mithilfe der angepassten Filterfunktion filtern. filterDataValues oder filterData können nicht verwendet werden.

Bestimmt, ob bei der Interaktion von Benutzern mit den Diagrammdaten auf dem Bildschirm Datentipps angezeigt werden. Stellen Sie diesen Wert auf false, um zu verhindern, dass die Serie Datentipps anzeigt oder Hitdaten generiert.

Der Standardwert ist true.

Ruft alle Elemente ab, die in der Serie nach dem Filtern vorhanden sind.

Einzelne Serien bestimmen die Liste der Elemente, die zurückgegeben werden sollen.

Ein Array von LegendData-Instanzen, die die Elemente beschreiben, die in einer Legende für diese Serie angezeigt werden. Abgeleitete Serienklassen überschreiben diese Abruffunktion und geben die Legendendaten zurück, die sich auf die Stile und die Datendarstellungsmethode beziehen. Die meisten Serientypen geben nur eine einzelne LegendData-Instanz zurück, einige (wie die PieSeries und StackedSeries) jedoch mehrere Instanzen, die einzelne Elemente im Array oder mehrere Möglichkeiten zum Rendern von Daten darstellen.

Speichert die Informationen, die zum Rendern dieser Serie erforderlich sind.

Gibt an, ob eine Serie auswählbar ist.

Der Standardwert ist true.

Indexposition des ausgewählten Elements im Datenprovider der Serie. Sind mehrere Elemente ausgewählt, bezieht sich diese Eigenschaft auf das zuletzt ausgewählte Element.

Ein Array von Indexpositionen der ausgewählten Elemente im Datenprovider der Serie.

Das in der Serie ausgewählte Diagrammelement. Sind mehrere Elemente ausgewählt, bezieht sich diese Eigenschaft auf das zuletzt ausgewählte Element.

Ein Array von in der Serie ausgewählten Diagrammelementen.

Eine durch einen gerade ausgeführten Übergang übergebene Renderdatenstruktur. Wenn ein Serieneffekt so eingestellt ist, dass er bei einer Serie wiedergegeben wird, erfasst er zunächst den aktuellen Zustand der Serie, indem er ihre Renderdaten abfragt. Der Übergang ändert die Renderdaten zum Erstellen des gewünschten Effekts und übergibt die Struktur wieder zur Anzeige an die Serie. Weist die Eigenschaft transitionRenderData einen anderen Wert als null auf, verwenden Serien ihre Inhalte zum Aktualisieren ihrer Anzeige.

Konstruktor.

Wird vom SeriesInterpolate-Effekt zum Initiieren eines Interpolationseffekts aufgerufen. Der Effekt übergibt die Quell- und Zieldaten für die Serie, zwischen deren Gliedern interpoliert werden soll. Der Effekt übergibt den Rückgabewert dieser Methode immer wieder an die interpolate()-Methode, um die Animation für die Dauer des Effekts fortzusetzen. Die Serie berechnet die Daten, die sie für die Durchführung der Interpolation benötigt, und gibt sie in dieser Methode zurück.

Parameter

Legt die in der Eigenschaft measureName von den ursprünglichen dataProvider-Elementen gespeicherten Werte temporär in der Eigenschaft fieldName des Diagrammelements ab. Hat die Eigenschaft measureName den Wert null oder weist einen leeren String auf, geht diese Methode davon aus, dass die ursprünglichen Datenproviderelemente Rohwerte sind und legt sie stattdessen im Zwischenspeicher ab.

Parameter

Legt die in der Eigenschaft measureName von den ursprünglichen dataProvider-Elementen gespeicherten Werte temporär in der Eigenschaft fieldName des Diagrammelements ab. Hat die Eigenschaft measureName den Wert null oder weist einen leeren String auf, speichert diese Methode die Indexposition der Elemente stattdessen in der Eigenschaft fieldName.

Parameter

Legt die in der Eigenschaft measureName von den ursprünglichen dataProvider-Elementen gespeicherten Werte temporär in der Eigenschaft fieldName des Diagrammelements ab.

Parameter

Aufgerufen durch das Diagramm, damit verknüpfte Elemente Stilselektoren von seinem chartSeriesStyles-Array anfordern können. Jedes Diagramm verfügt über einen ihm zugeordneten Satz von Selektoren, die implizit enthaltenen Elementen zugewiesen sind, die sie benötigen. Die Implementierung dieser Funktion gibt einem Element die Möglichkeit, je nach Bedarf, Elemente aus diesem Satz 'anzufordern'. Ein Element das N Stilselektoren benötigt, fordert die Werte von styles[firstAvailable] bis styles[firstAvailable + N - 1] an.

Parameter

Verarbeitet die Eigenschaften der Komponente. Dies ist eine erweiterte Methode, die Sie bei der Erstellung einer UIComponent-Unterklasse überschreiben können.

Sie können diese Methode nicht direkt aufrufen. Flex ruft die commitProperties()-Methode auf, wenn Sie die addChild()-Methode zum Hinzufügen einer Komponente zu einem Container verwenden oder wenn Sie die invalidateProperties()-Methode der Komponente aufrufen. Aufrufe der commitProperties()-Methode erfolgen vor Aufrufen der measure()-Methode. Auf diese Weise können Sie Eigenschaftswerte festlegen, die von der measure()-Methode verwendet werden können.

Manche Komponenten haben Eigenschaften, die sich auf die Anzahl und die Arten der von ihnen zu erstellenden untergeordneten Objekte auswirken. Oder sie haben Eigenschaften, die miteinander interagieren, wie etwa die Eigenschaften horizontalScrollPolicy und horizontalScrollPosition. Es ist oft am besten, zu Beginn alle diese Eigenschaften in einem Vorgang zu verarbeiten, um unnötige Mehrarbeit zu vermeiden.

Dies wird verwendet, wenn Sie keine benutzerdefinierte Funktion als filterFunction für die Serie festlegen. Einzelne Serien sollte das überschreiben.

Parameter

Die Standardprozedur für das dragStart-Ereignis.

Parameter

Wird vom SeriesInterpolate-Effekt zum Beenden eines Interpolationseffekts aufgerufen. Der Effekt verwendet diese Methode zum Abschließen der Interpolation und Bereinigen von ggf. mit diesem Effekt verknüpften temporären Zuständen.

Parameter

Extrahiert den Mindestwert, den Höchstwert und (optional) das Mindestintervall von einem Array von ChartItem-Objekten. Abgeleitete Klassen können diese Methode von ihren Implementierungen der describeData()-Methode aufrufen, um die Details der DataDescription-Struktur auszufüllen.

Parameter

Extrahiert den Mindestwert, den Höchstwert und (optional) das Mindestintervall von einem Array von ChartItem-Objekten. Abgeleitete Klassen können diese Methode von ihren Implementierungen der describeData()-Methode aufrufen, um die Details der DataDescription-Struktur auszufüllen.

Parameter

Normalerweise wird die Axis-Instanz direkt über eine benannte Eigenschaft, wie etwa horizontalAxis, verticalAxis oder radiusAxis für eine kartesische Serie, abgerufen.

Dies ist ein Low-level-Accessor.

Parameter

Füllt die Eigenschaften elementBounds, bounds und visibleBounds einer renderData-Struktur aus, die durch diese Serie generiert wird. Effektklassen rufen diese Methode auf, um diese Felder zur Verwendung bei der Implementierung verschiedener Effekttypen auszufüllen. Abgeleitete Klassen müssen diese Methode implementieren, um die Grenzen der Elemente in der Serie nur auf Anfrage zu generieren.

Parameter

Ruft alle Elemente in einem rechteckigen Bereich für die Serie ab. Rufen Sie diese Funktion auf, um festzustellen, welche Elemente in dieser Serie sich in einem bestimmten rechteckigen Bereich befinden.

Einzelne Serien bestimmen, ob ihr Diagrammelement sich unter diesem Bereich befindet. Der Punkt muss sich im globalen Koordinatenraum befinden.

Parameter

Verwandte API-Elemente

Füllt fehlende Werte in einer Interpolationsstruktur aus. Wenn eine Serie die initializeInterpolationData()-Methode aufruft, übergibt sie Arrays von Quell- und Zielwerten für die Interpolation. Ist einer der beiden Arrays unvollständig, muss die Serie „geeignete“ Platzhalterwerte für die Interpolation bereitstellen. Die Art und Weise, wie diese Platzhalterwerte bestimmt werden, hängt vom jeweiligen Serientyp ab. Serienerweiterungen müssen diese Methode zur Bereitstellung dieser Platzhalterwerte überschreiben.

Parameter