The set of all chart elements displayed in the chart. This includes series, second series, background elements, annotation elements, etc.

Sets an Array of ChartElements that appears on top of any data series rendered by the chart. Each item in the Array must subclass the mx.charts.DualStyleObject class and implement the IChartElement interface.

Sets an Array of background chart elements that appear below any data series rendered by the chart. Each item in the Array must subclass the mx.charts.DualStyleObject class and implement the IChartElement interface.

The current transition state of the chart. This property can be used to determine whether the chart is currently transitioning out its old data, transitioning in its new data, or has completed all transitions and is showing its current data set. See the mx.charts.chartClasses.ChartState enumeration for possible values.

Determines if Flex clips the chart to the area bounded by the axes. Set to false to clip the chart. Set to true to avoid clipping when the data is rendered.

Specifies the data provider for the chart. Data series rendered by the chart are assigned this data provider. To render disparate data series in the same chart, use the dataProvider property on the individual series.

This property can accept an Array or any other object that implements the IList or ICollectionView interfaces.

The area of the chart used to display data. This rectangle excludes the area used for gutters, axis lines and labels, and padding.

Specifies a callback method used to generate DataTips from values. This method should use the following signature:

   function dataTipFunction(hitData:HitData):String
   

This method returns a String that is displayed for each data point. The text can include HTML formatting. The single parameter is a HitData object that describes the data point.

The index of the child that is responsible for rendering DataTips. Derived classes that add additional visual elements to the chart should add it below this layer.

Specifies how Flex displays DataTip controls for the chart. DataTip controls are similar to ToolTips, except that they display an appropriate value representing the nearest chart data point under the mouse pointer.

Different chart elements might show different styles of DataTip controls. For example, a stacked chart element might show both the values of the column and the percentage it contributes to the whole.

You can customize DataTip controls with the dataTipFunction property. Possible values are:

• "single" - dataTips are shown for the closest dataPoint to the mouse cursor.
• multiple - dataTips are shown for any dataTip within range of the mouse cursor. You can control the sensitivity with the mouseSensitivity property.

A short description of the data described by the chart. Screen Readers use this property to describe the chart when accessibility is enabled.

This string defaults to the empty string, and must be explicitly assigned by the developer to have meaning.

The set of DisplayObjects representing the labels for the chart elements. Some series, annotation, and background types include overlays like elements, callouts, etc. If an element wants to display these overlays on top of all elements in the chart, they can pass a DisplayObject to the chart containing the overlays to be placed on top of all other chart elememnts. Chart implementors can access these overlay objects in the labelElements Array.

An Array of Legend items.

This property can be used as the source for data binding.

Specifies the distance, in pixels, that Flex considers a data point to be under the mouse pointer when the mouse moves around a chart. Flex considers any data point less than mouseSensitivity pixels away to be under the mouse pointer. This value is also used by the findDataPoints method.

The default value is 5.

An Array of Series objects that define the chart data. Each chart defines the type of Series objects that you use to populate this array. For example, a ColumnChart expects ColumnSeries objects as part of this Array. Some charts accept any object of type IChartElement as part of the Array, but in general each chart expects a specific type.

An Array of filters that are applied to all series in the chart. Assign an Array of Bitmap Filters to this property to apply them to all the series at once. Set the seriesFilter property to an empty Array to clear the default filters on the chart's series. Assigning filters to the seriesFilters property, which applies to all series, is more efficient than assigning them on individual series.

Specifies whether Flex shows DataTip controls for the chart. DataTip controls are similar to ToolTips, except that they display an appropriate value representing the nearest chart data point under the mouse pointer.

Different chart elements might show different styles of DataTip controls. For example, a stacked chart element might show both the values of the column and the percentage it contributes to the whole.

You can customize DataTip controls with the dataTipFunction property.

The DataTransforms managed by this chart. Each chart contains one or more data transform, representing a set of axes used to map from tuples from data space to screen space and vice-versa. Most charts only have a single DataTransform, but CartesianCharts that support second axes may manage a second DataTransform as needed.

Constructor.

Preprocesses the series and transform for display. You typically don't call this method directly. Instead, this function is called automatically during the chart's commitProperties() cycle when the series have been invalidated by a call to invalidateSeries().

By default, this method calls the customizeSeries() method once for each series in the set. Chart subclasses can override this function to add customization logic global to the whole series set.

Applies per-series customization and formatting to the series of the chart. This method is called once for each series when the series have been changed by a call to the invalidateSeries() method.

Converts a tuple of data values to an x-y coordinate on screen. Call this function to transform data on to the screen using the same transform that the individual elements go through. For example, to create a custom highlight for a data region of a chart, you might use this function to determine the on-screen coordinates of the range of interest.

For Cartesian charts, you typically pass two values. The first value maps to the horizontal axis, and the second value maps to the vertical axis.

For polar charts, the first value maps to the angular axis, and the second maps to the radial axis.

Returns an Array of HitData objects that describe the nearest data point to the coordinates passed to the method. The x and y arguments should be values in the ChartBase's coordinate system.

This method adheres to the limits specified by the mouseSensitivity property of the ChartBase object when looking for nearby data points.

See also

Retrieves the Axis instance for a particular dimension of the chart. This is a low level accessor. You typically retrieve the Axis directly through a named property (such as horizontalAxis, verticalAxis, or radiusAxis).

Informs the chart that the underlying data being displayed in the chart has been changed. Chart series and elements call this function when their rendering has changed in order to trigger a coordinated execution of show and hide data effects. You typically do not call this method on the chart directly.

Informs the chart that its child list has been modified and should be re-ordererd. Derived chart classes can call this method to trigger a call to its updateChildOrder() method on the next commitProperties() cycle.

This method triggers a redraw of the chart. Call this method when you add or change the chart's series or data providers.

Informs the chart that its series Array has been modified and should be re-processed. Derived chart classes can call this method to trigger a call to its updateSeries() method on the next commitProperties cycle.

Triggers a redraw of the chart. Call this method when you change the style properties of the chart's series.

Dispatches a new LegendDataChanged event.

Converts a coordinate on screen to a tuple of data values. Call this function to determine what data values a particular point on-screen represents.

Individual chart types determine how this transformation occurs. The point should be relative to the chart's coordinate space.

Defines the locations of DataTips on the chart. This method ensures that DataTips do not overlap each other (if multiple DataTips are visible) or their target data items.

Sizes the object. Unlike directly setting the width and height properties, calling the setActualSize() method does not set the explictWidth and explicitHeight properties, so a future layout calculation may result in the object returning to its previous size. This method is used primarily by component developers implementing the updateDisplayList() method, by Effects, and by the LayoutManager.

Assigns an axis instance to a particular dimension of the chart. This is a low level accessor. You typically set the Axis directly through a named property (such as horizontalAxis, verticalAxis, or radiusAxis).

Dispatched when a data point is found under the mouse pointer when it is clicked. Flex considers only data points within the radius determined by the mouseSensitivity property.

Dispatched when a data point is found under the mouse pointer when it is double clicked. Flex considers only data points within the radius determined by the mouseSensitivity property.

Dispatched when a data point is found under the mouse pointer when it is pressed down. Flex considers only data points within the radius determined by the mouseSensitivity property.

Dispatched when the mouse pointer moves while over a data point. Flex considers only data points within the radius determined by the mouseSensitivity property.

Dispatched when a data point is found under the mouse pointer when it is released. Flex considers only data points within the radius determined by the mouseSensitivity property.

Dispatched when the closest data point under the mouse pointer changes. Flex considers only data points within the radius determined by the mouseSensitivity property.

Dispatched when a new data point is found under the mouse pointer. Flex only considers data points within the radius determined by the mouseSensitivity property.