ColumnSeries  - AS3 Flex

Gibt die Breite der Spalten im Verhältnis zur Kategoriebreite an. Beim Wert 1 wird der gesamte Raum verwendet, beim Wert 0,6 dagegen 60 % des verfügbaren Raums der Säule. Normalerweise legen Sie diese Eigenschaft nicht direkt fest. Als eigentliche Säulenbreite wird entweder die Eigenschaft columnWidthRatio oder die Eigenschaft maxColumnWidth verwendet, abhängig davon, welcher Wert kleiner ist.

Der Standardwert ist 0.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:ColumnSeriesItem = ColumnSeriesItem(item);
          if (curItem.yNumber > 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:ColumnSeriesItem = ColumnSeriesItem(element);
          var ser:ColumnSeries = ColumnSeries(series);
          return(item.item.Country + ":" +"" + ser.yField.toString() +":"+ item.yNumber);
     }
     

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

Gibt das Feld des Datenproviders an, das die y-Achsenposition der Säulenunterseite 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 Säulen von der Mitte des verfügbaren Raums im Bezug zur Kategoriebreite entfernt ist. Mit der Standardeinstellung 0 werden die Säulen im Raum zentriert. Mit der Einstellung -50 wird die Säule am Anfang des verfügbaren Raums zentriert. Normalerweise legen Sie diese Eigenschaft nicht direkt fest. Das ColumnChart-Steuerelement verwaltet diesen Wert mithilfe der Eigenschaft columnWidthRatio.

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.

Fordert an, dass die Säulen vor dem Rendern von rechts nach links sortiert werden. Standardmäßig rendert die ColumnSeries Säulen in der Reihenfolge, in der sie im Datenprovider enthalten sind.

Wenn Sie die Eigenschaft xField verwenden, um die Position der einzelnen Säulen zu bestimmen, können die Säulen in einer anderen Reihenfolge auf dem Bildschirm angezeigt werden. Säulen können in einer beliebigen Reihenfolge gerendert werden. Einige angepasste Säulen setzen jedoch möglicherweise eine Sortierung von links nach rechts voraus.

Der Standardwert ist false.

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 Säule bestimmt. Bei null rendert Flex die Säulen in der Reihenfolge, in der sie im Datenprovider enthalten sind. Der Standardwert ist null.

Gibt das Feld des Datenproviders an, das die y-Achsenposition der Oberseite einer Säule bestimmt. Bei null geht die ColumnSeries davon aus, dass der Datenprovider ein Array von Zahlen ist und verwendet die Zahlen als Werte. 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.