BarSeries  - AS3 Flex

Gibt an, wie breit die Balken im Verhältnis zur Kategoriebreite gerendert werden sollen. Beim Wert 1 wird der gesamte Raum verwendet, beim Wert 0,6 dagegen 60 % des verfügbaren Raums des Balkens. Normalerweise legen Sie diese Eigenschaft nicht direkt fest. Als eigentliche Balkenbreite wird entweder die Eigenschaft barWidthRatio oder die Eigenschaft maxbarWidth verwendet, abhängig davon, welcher Wert kleiner ist.

Der Standardwert ist .65.

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:BarSeriesItem = BarSeriesItem(item);
          if (curItem.xNumber > 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.

Name eines Felds im Datenprovider, dessen Wert als Beschriftung angezeigt wird. Diese Eigenschaft wird ignoriert, wenn die Eigenschaft labelFunction angegeben ist.

Gibt eine Rückruffunktion zum Rendern jeder Beschriftung der Serie an. Eine labelFunction muss folgende Signatur aufweisen:

     function function_name(element:ChartItem, series:Series):String { ... }
     

Beispiel für die Verwendung einer angepassten labelFunction:

     private function myLabelFunction(element:ChartItem, series:Series):String {
          var item:BarSeriesItem = BarSeriesItem(element);
          var ser:BarSeries = BarSeries(series);
          return(item.item.Country + ":" +"" + ser.xField.toString() +":"+ item.xNumber);
     }
     

Gibt die Breite der Balken in Pixeln an. Als eigentliche Balkenbreite wird entweder dieser Stil oder die Eigenschaft barWidthRatio verwendet, abhängig davon, welcher Wert kleiner ist. Bei gruppierten Balken wird dieser Raum anteilsmäßig zwischen den Balken in jeder Gruppe aufgeteilt.

Gibt das Feld des Datenproviders an, das die Unterseite jedes Balkens bestimmt. Bei null basieren die Säulen auf dem Mindestwert des Bereichs (oder auf dem Höchstwert, wenn der Feldwert negativ ist).

Der Standardwert ist null.

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.

Gibt an, wie weit die Mitte der Balken von der Mitte des verfügbaren Raums im Bezug zur Kategoriebreite entfernt ist. Der Wertebereich ist ein Prozentsatz zwischen -100 und 100. Bei der Einstellung 0 werden die Balken im Raum zentriert. Bei der Einstellung -50 wird die Säule am Anfang des verfügbaren Raums zentriert. Normalerweise legen Sie diese Eigenschaft nicht direkt fest.

Der Standardwert ist 0.

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.

Die StackedSeries, die mit dieser BarSeries verknüpft ist. Der Stacker verwaltet das Stapelverhalten der Serie.

Die Gesamtsummen des Stapels für die Serie.

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 der Oberseite jedes Balkens bestimmt. Bei null geht die BarSeries davon aus, dass der Datenprovider ein Array von Zahlen ist und verwendet die Zahlen als Werte.

Der Standardwert ist null.

Gibt das Feld des Datenproviders an, das die y-Achsenposition der Unterseite jedes Balkens im Diagramm bestimmt. Bei null zeigt Flex die Balken in der Reihenfolge der Daten im Datenprovider an.

Der Standardwert ist null.

Konstruktor.

Passt die Elementrenderer-Instanzen an, die zur Darstellung des Diagramms verwendet werden. Diese Methode wird automatisch aufgerufen, wenn ein neuer Elementrenderer benötigt wird, während das Diagramm gerendert wird. Sie können diese Methode überschreiben, um bei Bedarf Ihre eigene Anpassung hinzuzufügen.

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.

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

Eine Komponente, die andere Komponenten oder Objekte in sich selbst erstellt, wird als „zusammengesetzte Komponente“ bezeichnet. Dies trifft beispielsweise dann zu, wenn das Flex ComboBox-Steuerelement tatsächlich aus einem TextInput-Steuerelement zum Definieren des Textbereichs der ComboBox und einem Schaltflächen-Steuerelement zum Definieren des ComboBox-Pfeils zusammengesetzt ist. Komponenten implementieren die createChildren()-Methode zum Erstellen untergeordneter Objekte (wie etwa andere Komponenten) innerhalb der Komponente.

Sie rufen aus der Überschreibung der createChildren()-Methode zum Hinzufügen jedes der untergeordneten Objekte die addChild()-Methode auf.

Sie können diese Methode nicht direkt aufrufen. Flex ruft die createChildren()-Methode als Antwort auf die den Aufruf der addChild()-Methode auf, um die Komponente seinem übergeordneten Objekt hinzuzufügen.

Informiert die Serie, dass die zugrunde liegenden Daten im Datenprovider geändert wurden. Diese Funktion ruft die updateData()-, updateMapping()-, updateFilter()- und updateTransform()-Methode beim nächsten Aufruf der commitProperties()-Methode auf. Wenn Datenelementen im Diagramm Dateneffekte zugewiesen sind, werden sie durch diese Methode angezeigt oder ausgeblendet.

Parameter