BarSeries  - AS3 Flex

Specifies how wide to render the bars relative to the category width. A value of 1 uses the entire space, while a value of .6 uses 60% of the bar's available space. You typically do not set this property directly. The actual bar width used is the smaller of barWidthRatio and the maxbarWidth property

The default value is .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:BarSeriesItem = BarSeriesItem(item);
          if (curItem.xNumber > 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:BarSeriesItem = BarSeriesItem(element);
          var ser:BarSeries = BarSeries(series);
          return(item.item.Country + ":" +"" + ser.xField.toString() +":"+ item.xNumber);
     }
     

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

Specifies the field of the data provider that determines the bottom of each bar. 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 bars from the center of the available space, relative the category width. The range of values is a percentage in the range -100 to 100. Set to 0 to center the bars in 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 default value is 0.

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.

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 top of each bar. If null, the BarSeries assumes that the data provider is an Array of numbers, and uses the numbers as values.

The default value is null.

Specifies the field of the data provider that determines the y-axis location of the bottom of each bar in the chart. If null, Flex arranges the bars in the order of the data in the data provider.

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.