ColumnSeries  - AS3 Flex

Specifies the width of columns relative to the category width. A value of 1 uses the entire space, while a value of .6 uses 60% of the column's available space. You typically do not set this property directly. The actual column width used is the smaller of columnWidthRatio and the maxColumnWidth property.

The default value is 0.65.

Specifies a method that returns the fill for the current chart item in the series. If this property is set, the return value of the custom fill function takes precedence over the fill and fills style properties. But if it returns null, then fills and fill will be prefered in that order.

The custom fillFunction has the following signature:

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

An example usage of a customized fillFunction is to return a fill based on some threshold.

     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));
     }
     

If you specify a custom fill function for your chart series and you want to have a Legend control, you must manually create a Legend control and add LegendItems to it.

Defines the labels, tick marks, and data position for items on the x-axis. Use either the LinearAxis class or the CategoryAxis class to set the properties of the horizontalAxis as a child tag in MXML or create a LinearAxis or CategoryAxis object in ActionScript.

Gets all the items that are there in the series after filtering.

Individual series determine the list of items that are to be returned.

The subtype of ChartItem used by this series to represent individual items. Subclasses can override and return a more specialized class if they need to store additional information in the items

Name of a field in the data provider whose value appears as the label. This property is ignored if the labelFunction property is specified.

Specifies a callback function used to render each label of the Series. A labelFunction must have the following signature:

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

An example usage of a customized labelFunction is as follows:

     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);
     }
     

Specifies the width of the columns, in pixels. The actual column width used is the smaller of this style and the columnWidthRatio property. Clustered columns divide this space proportionally among the columns in each cluster.

Specifies the field of the data provider that determines the y-axis location of the bottom of a column. If null, the columns are based at the range minimum (or maximum, if the field value is negative). The default value is null.

A module factory is used as context for using embedded fonts and for finding the style manager that controls the styles for this component.

Specifies how far to offset the center of the columns from the center of the available space, relative to the category width. At the value of default 0, the columns are centered on the space. Set to -50 to center the column at the beginning of the available space. You typically do not set this property directly. The ColumnChart control manages this value based on its columnWidthRatio property.

The subtype of ChartRenderData used by this series to store all data necessary to render. Subclasses can override and return a more specialized class if they need to store additional information for rendering.

Requests the columns be sorted from left to right before rendering. By default, the ColumnSeries renders columns in the order they appear in the data provider.

If you use the xField property to determine the position of each column, columns can appear in a different order on the screen. Columns can be rendered in any order. However, some custom columns might rely on the columns being rendered from left to right.

The default value is false.

The StackedSeries associated with this BarSeries. The stacker manages the series's stacking behavior.

The stack totals for the series.

Defines the labels, tick marks, and data position for items on the y-axis. Use either the LinearAxis class or the CategoryAxis class to set the properties of the verticalAxis as a child tag in MXML or create a LinearAxis or CategoryAxis object in ActionScript.

Specifies the field of the data provider that determines the x-axis location of the column. If null, Flex renders the columns in the order they appear in the data provider. The default value is null.

Specifies the field of the data provider that determines the y-axis location of the top of a column. If null, the ColumnSeries assumes the data provider is an Array of numbers and uses the numbers as values. The default value is null.

Constructor.

Customizes the item renderer instances that are used to represent the chart. This method is called automatically whenever a new item renderer is needed while the chart is being rendered. You can override this method to add your own customization as necessary.

Parameters

Processes the properties set on the component. This is an advanced method that you might override when creating a subclass of UIComponent.

You do not call this method directly. Flex calls the commitProperties() method when you use the addChild() method to add a component to a container, or when you call the invalidateProperties() method of the component. Calls to the commitProperties() method occur before calls to the measure() method. This lets you set property values that might be used by the measure() method.

Some components have properties that affect the number or kinds of child objects that they need to create, or have properties that interact with each other, such as the horizontalScrollPolicy and horizontalScrollPosition properties. It is often best at startup time to process all of these properties at one time to avoid duplicating work.

Create child objects of the component. This is an advanced method that you might override when creating a subclass of UIComponent.

A component that creates other components or objects within it is called a composite component. For example, the Flex ComboBox control is actually made up of a TextInput control to define the text area of the ComboBox, and a Button control to define the ComboBox arrow. Components implement the createChildren() method to create child objects (such as other components) within the component.

From within an override of the createChildren() method, you call the addChild() method to add each child object.

You do not call this method directly. Flex calls the createChildren() method in response to the call to the addChild() method to add the component to its parent.