套件 | mx.charts.chartClasses |
介面 | public interface IAxis extends IEventDispatcher |
實作者 | CategoryAxis, NumericAxis |
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Classes implement this interface to provide range definition functionality.
相關 API 元素
屬性 | 定義自 | ||
---|---|---|---|
baseline : Number [唯讀]
The baseline position for the axis. | IAxis | ||
chartDataProvider : Object [唯寫]
The data provider assigned to the enclosing chart. | IAxis | ||
displayName : String [唯讀]
The name of the axis. | IAxis | ||
title : String [唯讀]
The text for the title displayed along the axis. | IAxis | ||
unitSize : Number [唯讀]
The size of one unit of data as represented by this axis. | IAxis |
方法 | 定義自 | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式,以便讓偵聽程式收到事件的通知。 | IEventDispatcher | ||
Triggers events that inform the range object
when the chart data has changed. | IAxis | ||
會將事件傳送到事件流程。 | IEventDispatcher | ||
Filters a set of values of arbitrary type
to a set of numbers that can be mapped. | IAxis | ||
Formats values for display in DataTips. | IAxis | ||
Determines the range to estimate what the axis labels should be. | IAxis | ||
Gets the labels text that is rendered. | IAxis | ||
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | IEventDispatcher | ||
Maps a position along the axis back to a numeric data value. | IAxis | ||
Converts a set of values of arbitrary type
to a set of numbers that can be transformed into screen coordinates. | IAxis | ||
Determines how the axis handles overlapping labels. | IAxis | ||
Invoked when an AxisRenderer is unable to cleanly render
the labels without overlap, and would like the Axis object
to reduce the set of labels. | IAxis | ||
Each DataTransform that makes use of an axis
registers itself with that axis. | IAxis | ||
會從 EventDispatcher 物件移除偵聽程式。 | IEventDispatcher | ||
Maps a set of values from data space to screen space. | IAxis | ||
Each DataTransform that makes use of an axis
registers itself with that axis. | IAxis | ||
Updates the chart. | IAxis | ||
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式,或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | IEventDispatcher |
baseline | 屬性 |
baseline:Number
[唯讀] 語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
The baseline position for the axis. Some series, such as ColumnSeries or AreaSeries, use this value to define the base of a filled region when no minimum value is specified.
實作
public function get baseline():Number
chartDataProvider | 屬性 |
chartDataProvider:Object
[唯寫] 語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
The data provider assigned to the enclosing chart.
Axis types that are data provider-based can choose to inherit
the data provider associated with the enclosing chart.
If an axis is shared among multiple charts,
the value of this property is undefined
(most likely it will be the last data provider assigned
to one of the associated charts).
實作
public function set chartDataProvider(value:Object):void
displayName | 屬性 |
title | 屬性 |
unitSize | 屬性 |
unitSize:Number
[唯讀] 語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
The size of one unit of data as represented by this axis.
This value is used by various series types to help in rendering.
The ColumnSeries class, for example, uses this value
to determine how wide columns should be rendered.
Different axis types return different values,
sometimes dependent on the data being represented.
The DateTimeAxis class, for example, might return the number
of milliseconds in a day, or a year, depending on the data
that is rendered in the chart.
Because this value is dependant on collecting the represented data,
custom series cannot assume this value is accurate in their
updateData()
or updateMapping()
methods.
實作
public function get unitSize():Number
dataChanged | () | 方法 |
public function dataChanged():void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Triggers events that inform the range object when the chart data has changed.
filterCache | () | 方法 |
public function filterCache(cache:Array, field:String, filteredString:String):void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Filters a set of values of arbitrary type to a set of numbers that can be mapped.
參數
cache:Array — An Array of objects where converted values
are read from and stored.
| |
field:String — The field of the objects in the cache Array
containing the pre-filtered values.
| |
filteredString:String — The field of the objects in the cache Array
where filtered values should be stored.
|
formatForScreen | () | 方法 |
getLabelEstimate | () | 方法 |
public function getLabelEstimate():AxisLabelSet
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Determines the range to estimate what the axis labels should be.
The axis almost immediately calls the getLabels()
method
to get the real values.
The axis uses the estimated values to adjust chart margins,
so any difference between the estimated labels and actual labels
(returned from the getLabels()
method) results in scaling
the labels to fit.
An axis need only return the minimum and maximum labels when returning an estimate. If the label set is fairly static, without depending on the size of the axis being rendered on screen, an axis can return the entire label set from this function, and mark the estimate as accurate.
傳回值AxisLabelSet — An Array of AxisLabel objects.
|
getLabels | () | 方法 |
public function getLabels(minimumAxisLength:Number):AxisLabelSet
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Gets the labels text that is rendered. When Flex calls this method, the axis has already determined the minimum length of the label.
參數
minimumAxisLength:Number — The minimum length of the axis, in pixels.
The axis can be longer than this value, but not shorter.
|
AxisLabelSet — An array of AxisLabel objects.
|
invertTransform | () | 方法 |
public function invertTransform(value:Number):Object
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Maps a position along the axis back to a numeric data value.
參數
value:Number — The bound of the axis.
This parameter should be between 0 and 1,
with 0 representing the minimum bound of the axis, and 1 the maximum.
|
Object — An object containing the transformed value.
|
mapCache | () | 方法 |
public function mapCache(cache:Array, field:String, convertedField:String, indexValues:Boolean = false):void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Converts a set of values of arbitrary type to a set of numbers that can be transformed into screen coordinates.
參數
cache:Array — An Array of objects where converted values
are read from and stored.
| |
field:String — The field of the objects in the cache Array
containing the pre-converted values.
| |
convertedField:String — The field of the objects in the cache Array
where converted values should be stored.
| |
indexValues:Boolean (default = false ) — This parameter is true if the values being mapped
are index values, and false if they are natural data values.
|
preferDropLabels | () | 方法 |
public function preferDropLabels():Boolean
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Determines how the axis handles overlapping labels.
Typically, numeric ranges return true
,
while discrete value-based ranges do not.
You can can override this property by setting it directly on the axis.
Boolean — true if labels can be dropped without loss of data;
otherwise, false .
|
reduceLabels | () | 方法 |
public function reduceLabels(intervalStart:AxisLabel, intervalEnd:AxisLabel):AxisLabelSet
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Invoked when an AxisRenderer is unable to cleanly render the labels without overlap, and would like the Axis object to reduce the set of labels. The method is passed the two labels that are overlapping.
參數
intervalStart:AxisLabel — The start of the interval where labels overlap.
| |
intervalEnd:AxisLabel — The end of the interval where labels overlap.
|
AxisLabelSet — A new label set that resolves the overlap by reducing
the number of labels.
|
registerDataTransform | () | 方法 |
public function registerDataTransform(transform:mx.charts.chartClasses:DataTransform, dimensionName:String):void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Each DataTransform that makes use of an axis registers itself with that axis. The axis is responsible for informing the transform when its relevant values have changed. It should also request values from the transform when it wants to autogenerate minimum and maximum values.
參數
transform:mx.charts.chartClasses:DataTransform — The DataTransform to register.
| |
dimensionName:String — The name of the dimension.
|
transformCache | () | 方法 |
public function transformCache(cache:Array, field:String, convertedField:String):void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Maps a set of values from data space to screen space.
參數
cache:Array — An Array of objects where mapped values
are read from and stored.
| |
field:String — The field of the objects in the cache Array
containing the pre-mapped values.
| |
convertedField:String — The field of the objects in the cache Array
where mapped values should be stored.
|
unregisterDataTransform | () | 方法 |
public function unregisterDataTransform(transform:mx.charts.chartClasses:DataTransform):void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Each DataTransform that makes use of an axis registers itself with that axis. The axis is responsible for informing the transform when its relevant values have changed. It should also request values from the transform when it wants to autogenerate minimum and maximum values.
參數
transform:mx.charts.chartClasses:DataTransform — The DataTransform to unregister.
|
update | () | 方法 |
public function update():void
語言版本: | ActionScript 3.0 |
產品版本: | Flex 3 |
執行階段版本: | Flash Player 9, AIR 1.1 |
Updates the chart. This can be called multiple times per frame.
Tue Jun 12 2018, 03:47 PM Z