BubbleSeries  - AS3 Flex

Gibt eine Methode an, die die Füllung für das aktuelle Diagrammelement in der Serie zurückgibt. Wenn diese Eigenschaft festgelegt ist, hat der Rückgabewert der angepassten Füllfunktion Vorrang vor den Stileigenschaften fill und fills. Wenn allerdings null zurückgegeben wird, werden fills und fill (in dieser Reihenfolge) bevorzugt.

Die angepasste fillFunction hat die folgende Signatur:

     function_name (item:ChartItem, index:Number):IFill { ... }
     

Ein Beispiel für die Verwendung einer angepassten fillFunction ist die Rückgabe einer Füllung auf der Basis eines Schwellenwerts.

     public function myFillFunction(item:ChartItem, index:Number):IFill {
          var curItem:BubbleSeriesItem = BubbleSeriesItem(item);
          if (curItem.zNumber > 10)
              return(new SolidColor(0x123456, .75));
          else
              return(new SolidColor(0x563412, .75));
     }
     

Wenn Sie eine angepasste Füllfunktion für Ihre Diagrammserie angeben und über ein Legendensteuerelement verfügen möchten, müssen Sie das Legendensteuerelement manuell erstellen und LegendItems hinzufügen.

Definiert die Beschriftungen, Markierungen und Datenpositionen für Elemente auf der x-Achse. Verwenden Sie die LinearAxis- oder CategoryAxis-Klasse, um die Eigenschaften der horizontalAxis als untergeordnetes Tag in MXML festzulegen, oder erstellen Sie ein LinearAxis- oder CategoryAxis-Objekt in ActionScript.

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.

Der untergeordnete ChartItem-Typ, der von dieser Serie zur Darstellung einzelner Elemente verwendet wird. Unterklassen können eine spezialisiertere Klasse überschreiben und zurückgeben, wenn zusätzliche Informationen in den Elementen gespeichert werden müssen.

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.

Der Radius des größten gerenderten Elements in dieser Serie. Bei Verwendung eines BubbleSeries-Objekts in einem BubbleChart weist das Diagramm automatisch seinen maxRadius-Stilwert dieser Eigenschaft in allen Serien des Diagramms zu. Bei Verwendung eines BubbleSeries-Objekten in CartesianChart-Steuerelementen verwalten Sie diese Eigenschaft manuell.

Der Radius des kleinsten gerenderten Elements in dieser Serie. Bei Verwendung eines BubbleSeries-Objekts in einem BubbleChart weist das Diagramm automatisch seinen minRadius-Stilwert dieser Eigenschaft in allen Serien des Diagramms zu. Bei Verwendung eines BubbleSeries-Objekten in CartesianChart-Steuerelementen verwalten Sie diese Eigenschaft manuell.

Eine Modul-Factory wird als Kontext für die Verwendung eingebetteter Schriftarten und für die Suche nach dem Stilmanager, der die Stile dieser Komponente steuert, verwendet.

Die Achse, der der Blasenradius der zugeordnet ist. In Blasendiagrammen wird die Größe der einzelnen Blasen als dritte Dimension verwendet, die ähnlich wie die x- und y-Positionen umgewandelt wird. Standardmäßig entspricht radiusAxis einer linearen Achse, wobei die Eigenschaft autoAdjust auf false gesetzt ist.

Das Feld des Datenproviders, das den Radius jedes Symbols relativ zu den anderen Datenpunkten im Diagramm bestimmt.

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

Der untergeordnete ChartRenderData-Typ, der von dieser Serie zum Speichern der zum Rendern benötigten Daten verwendet wird. Unterklassen können eine spezialisiertere Klasse überschreiben und zurückgeben, wenn zusätzliche Informationen zum Rendern gespeichert werden müssen.

Definiert die Beschriftungen, Markierungen und Datenpositionen für Elemente auf der y-Achse. Verwenden Sie die LinearAxis- oder CategoryAxis-Klasse, um die Eigenschaften der verticalAxis als untergeordnetes Tag in MXML festzulegen, oder erstellen Sie ein LinearAxis- oder CategoryAxis-Objekt in ActionScript.

Gibt das Feld des Datenproviders an, das die x-Achsenposition jedes Datenpunkts bestimmt. Bei null rendert Flex die Datenpunkte in der Reihenfolge, in der sie im Datenprovider enthalten sind.

Der Standardwert ist null.

Gibt das Feld des Datenproviders an, das die y-Achsenposition jedes Datenpunkts bestimmt. Bei null geht die BubbleSeries davon aus, dass der Datenprovider ein Array von Zahlen ist und verwendet die Zahlen als Werte für die Datenpunkte.

Der Standardwert ist null.

Konstruktor.

Wendet die Stileigenschaften auf das DisplayObject an. Diese Methode ist der von dem Instanzcache bei der Erstellung eines neuen Renderers verwendete Rückruf.

Parameter

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

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.

Wird durch das steuernde DataTransform aufgerufen, um eine Beschreibung der durch dieses IChartElement dargestellten Daten zu erhalten. Implementoren füllen ein Array von mx.charts.chartClasses.DataDescription-Objekten aus und geben es zurück, um sicherzustellen, dass ihre Daten von Achsen, die Werte aus den angezeigten Daten (wie „minimum“, „maximum“, „interval“ und „unitSize“) automatisch generieren, korrekt abgerufen werden. Die meisten Elementtypen geben ein Array zurück, das nur eine DataDescription enthält. Kombinierte Elemente, wie BarSet und ColumnSet geben möglicherweise mehrere DataDescription-Instanzen zurück, die die von ihren Unterelementen angezeigten Daten beschreiben. Bei entsprechendem Aufruf beschreibt der Implementor die Daten entlang der durch das Argument dimension angegebenen Achse. Diese Funktion wird möglicherweise für jede von dem übergeordneten Diagramm unterstützte Achse aufgerufen.

Parameter

Sucht den nächsten Datenpunkt, der von dem Element unter den angegebenen Koordinaten dargestellt wird.

Diese Methode gibt ein Array von HitData-Strukturen zurück, die die Datenpunkte innerhalb des Bereichs beschreiben. Einzelne ChartElements geben möglicherweise nur einen einzigen dataPoint wieder, wenn sichergestellt ist, dass sich die dataPoints nicht überschneiden.

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

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

Erkennt Änderungen an Stileigenschaften. Ist eine Stileigenschaft eingestellt, ruft Flex die styleChanged()-Methode auf und übergibt an sie den Namen des eingestellten Stils.

Dies ist eine erweiterte Methode, die Sie bei der Erstellung einer UIComponent-Unterklasse überschreiben können. Wenn Sie eine benutzerdefinierte Komponente erstellen, können Sie die styleChanged()-Methode überschreiben, um den an sie übergebenen Stilnamen zu prüfen, und die Änderung entsprechend verarbeiten. Auf diese Weise können Sie das Standardverhalten eines vorhandenen Stils überschreiben oder Ihre eigenen benutzerdefinierten Stileigenschaften hinzufügen.

Bei einer Stileigenschaft muss Ihre Überschreibung der styleChanged()-Methode die invalidateDisplayList()-Methode aufrufen, damit Flex die updateDisplayList()-Methode der Komponente bei der nächsten Bildschirmaktualisierung ausführt.

Parameter

Wird aufgerufen, wenn die von der Serie dargestellten Daten geändert wurden und erneut aus dem Datenprovider geladen werden müssen. Wenn Sie die angepassten Serientypen implementieren, müssen Sie diese Methode überschreiben und alle zum Anzeigen der Serie erforderlichen Daten aus dem zugrunde liegenden Datenprovider laden. Sie müssen auch sicherstellen, dass die super.updateData()-Methode in Ihrer Unterklasse aufgerufen wird. Im Allgemeinen rufen Sie diese Methode nicht direkt auf. Um sicherzustellen, dass Ihre Daten an einem bestimmten Punkt aktualisiert wurden, rufen Sie stattdessen die validateData()-Methode der Series-Klasse auf.

Zeichnet die Objekte und/oder Größen und platziert die untergeordneten Elemente. 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 updateDisplayList()-Methode auf, wenn eine Komponente einem Container mit der addChild()-Methode hinzugefügt wird und die invalidateDisplayList()-Methode der Komponente aufgerufen wird.

Bei Komponenten ohne untergeordnete Elemente verwenden Sie hier das programmgesteuerte Zeichnen mit Methoden der Grafikobjekte einer Komponente wie graphics.drawRect().

Bei Komponenten mit untergeordneten Elementen rufen Sie hier die move()- und setActualSize()-Methode in den untergeordneten Elementen auf.

Komponenten können programmgesteuert zeichnen, auch wenn sie untergeordnete Objekte haben. Verwenden Sie dabei die Eigenschaften unscaledWidth und unscaledHeight der Komponente als Grenzen.

Es ist wichtig, dass Sie die Eigenschaften unscaledWidth und unscaledHeight statt der Eigenschaften width und height verwenden.

Parameter

Wird aufgerufen, wenn die von der Serie dargestellten Daten anhand der Bereiche gefiltert werden müssen, die auf den Achsen der zugehörigen Datentransformation dargestellt werden. Dazu kann es kommen, wenn die zugrunde liegenden Daten geändert wurden oder der Bereich der zugehörigen Achsen geändert wurde. Wenn Sie einen angepassten Serientyp implementieren, müssen Sie diese Methode überschreiben und alle außerhalb liegenden Daten filtern, indem Sie die filterCache()-Methode der Achsen verwenden, die von der verknüpften Datentransformation gesteuert werden. Die filterCache()-Methode wandelt alle Werte, die außerhalb des Bereichs liegen, in NaN um. Sie müssen sicherstellen, dass die super.updateFilter()-Methode in Ihrer Unterklasse aufgerufen wird. Im Allgemeinen rufen Sie diese Methode nicht direkt auf. Um sicherzustellen, dass Ihre Daten an einem bestimmten Punkt gefiltert wurden, rufen Sie stattdessen die validateTransform()-Methode der Series-Klasse auf. Sie können im Allgemeinen davon ausgehen, dass Ihre updateData()- und Ihre updateMapping()-Methode vor dieser Methode aufgerufen wurden, falls dies erforderlich war.

Wird aufgerufen, wenn die von der Serie dargestellten Daten numerischen Entsprechungen zugeordnet werden müssen. Dazu kann es kommen, wenn die zugrunde liegenden Daten oder die zur Darstellung der Serie verwendeten Achsen geändert wurden. Wenn Sie eine angepasste Serie implementieren, müssen Sie diese Methode überschreiben und alle dargestellten Daten in numerische Werte konvertieren, indem Sie die mapCache()-Methode der Achsen verwenden, die von der verknüpften Datentransformation verwaltet werden. Sie müssen außerdem sicherstellen, dass die super.updateMapping()-Methode in Ihrer Unterklasse aufgerufen wird. Im Allgemeinen rufen Sie diese Methode nicht direkt auf. Um sicherzustellen, dass Ihre Daten an einem bestimmten Punkt zugeordnet wurden, rufen Sie stattdessen die validateData()-Methode der Series-Klasse auf. Sie können im Allgemeinen davon ausgehen, dass Ihre updateData()-Methode vor dieser Methode aufgerufen wurde, falls dies erforderlich war.

Wird aufgerufen, wenn die von der zugrunde liegenden Serie dargestellten Daten von den Achsen der zugehörigen Datentransformation in Bildschirmwerte umgewandelt werden müssen. Dazu kann es kommen, wenn die zugrunde liegenden Daten, der Bereich der zugehörigen Achsen oder die Größe des Bereichs auf dem Bildschirm geändert wurde. Wenn Sie einen angepassten Serientyp implementieren, müssen Sie diese Methode überschreiben und die Daten transformieren, indem Sie die transformCache()-Methode der verknüpften Datentransformation verwenden. Sie müssen sicherstellen, dass die super.updateTransform()-Methode in Ihrer Unterklasse aufgerufen wird. Im Allgemeinen rufen Sie diese Methode nicht direkt auf. Um sicherzustellen, dass Ihre Daten an einem bestimmten Punkt gefiltert wurden, rufen Sie stattdessen die valiateTransform()-Methode der Series-Klasse auf. Sie können im Allgemeinen davon ausgehen, dass Ihre updateData()-, updateMapping() und updateFilter()-Methoden vor dieser Methode aufgerufen wurden, falls dies erforderlich war.

Die Art der Radiusachse.