| 套件 | mx.charts.chartClasses |
| 類別 | public class NumericAxis |
| 繼承 | NumericAxis  AxisBase EventDispatcher Object |
| 實作 | IAxis |
| 子類別 | DateTimeAxis, LinearAxis, LogAxis |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
更多範例
相關 API 元素
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
| autoAdjust : Boolean
Specifies whether Flex rounds values. | NumericAxis | ||
| baseAtZero : Boolean
Specifies whether Flex tries to keep the minimum
and maximum values rooted at zero. | NumericAxis | ||
| baseline : Number [唯讀]
The computed minimum value for the axis
as long as this value is greater than 0. | NumericAxis | ||
 | chartDataProvider : Object [唯寫]
The data provider assigned to the enclosing chart. | AxisBase | |
| computedMaximum : Number
The computed maximum value represented by this axis. | NumericAxis | ||
| computedMinimum : Number
The computed minimum value represented by this axis. | NumericAxis | ||
| constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| direction : String
Determines the direction in which the axis is rendered. | NumericAxis | ||
| displayName : String
The name of the axis. | AxisBase | |
| labelFunction : Function
Called to format axis values for display as labels. | NumericAxis | ||
| minorTicks : Array [唯讀]
An Array of minor tick marks generated to represent this axis. | NumericAxis | ||
| padding : Number
Specifies padding that Flex adds to the calculated minimum and maximum
values for the axis when rendering the values on the screen. | NumericAxis | ||
| parseFunction : Function
Specify a parseFunction to customize how
the values rendered by your chart are converted into numeric values. | NumericAxis | ||
| title : String
The text for the title displayed along the axis. | AxisBase | |
| unitSize : Number [唯讀]
The size of one unit of data as represented by this axis. | AxisBase | |
| 屬性 | 定義自 | ||
|---|---|---|---|
| assignedMaximum : Number
The explicitly assigned maximum value. | NumericAxis | ||
| assignedMinimum : Number
The explicitly assigned minimum value. | NumericAxis | ||
| computedInterval : Number
The computed interval represented by this axis. | NumericAxis | ||
| dataDescriptions : Array [唯讀]
An Array of DataDescription structures describing the data being represented by the chart. | NumericAxis | ||
| labelCache : Array
The most recent set of AxisLabel objects
generated to represent this axis. | NumericAxis | ||
| labelMaximum : Number
The maximum value where a label should be placed. | NumericAxis | ||
| labelMinimum : Number
The minimum value where a label should be placed. | NumericAxis | ||
| minorTickCache : Array
The most recent set of minor tick marks generated to represent this axis. | NumericAxis | ||
| requiredDescribedFields : uint [唯讀]
The fields of the DescribeData structure that this axis is interested in. | NumericAxis | ||
| ticks : Array [唯讀]
An Array of tick marks for this axis. | NumericAxis | ||
| 方法 | 定義自 | ||
|---|---|---|---|
Constructor. | NumericAxis | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。 | EventDispatcher | |
|
Triggers events that inform the range object
when the chart data has changed. | AxisBase | |
|
會將事件傳送到事件流程。 | EventDispatcher | |
Filters a set of values of arbitrary type
to a set of numbers that can be mapped. | NumericAxis | ||
Formats values for display in DataTips. | NumericAxis | ||
Determines the range to estimate what the axis labels should be. | NumericAxis | ||
Gets the labels text that is rendered. | NumericAxis | ||
|
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | |
|
指出物件是否有已定義的指定屬性。 | Object | |
Maps a position along the axis back to a numeric data value. | NumericAxis | ||
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
Converts a set of values of arbitrary type
to a set of numbers that can be transformed into screen coordinates. | NumericAxis | ||
Determines how the axis handles overlapping labels. | NumericAxis | ||
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
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. | NumericAxis | ||
|
Each DataTransform that makes use of an axis
registers itself with that axis. | AxisBase | |
|
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
Maps a set of values from data space to screen space. | NumericAxis | ||
|
Each DataTransform that makes use of an axis
registers itself with that axis. | AxisBase | |
Updates the chart. | NumericAxis | ||
|
會傳回指定之物件的基本值。 | Object | |
|
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher | |
| 方法 | 定義自 | ||
|---|---|---|---|
Adjusts the generated or assigned range of the axis's labels. | NumericAxis | ||
Populates the labelCache property with labels representing the current
values of the axis. | NumericAxis | ||
Builds an Array of positions for the minor tick marks Array that is generated by this axis. | NumericAxis | ||
|
Called by the governing DataTransform to obtain a description
of the data represented by this IChartElement. | AxisBase | |
Protects the range against invalid values for this axis type. | NumericAxis | ||
Invalidates the cached labels and tick marks that represent this axis's values. | NumericAxis | ||
assignedMaximum | 屬性 |
protected var assignedMaximum:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The explicitly assigned maximum value.
If no value has been assigned, this will be NaN.
Typically, calculations should be performed
with the computedMaximum field.
assignedMinimum | 屬性 |
protected var assignedMinimum:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The explicitly assigned minimum value.
If no value has been assigned, this will be NaN.
Typically calculations should be performed
with the computedMinimum field.
autoAdjust | 屬性 |
autoAdjust:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Specifies whether Flex rounds values.
If false, Flex does not round the values
set by the minimum and maximum properties,
or modify the default minimum and
maximum values.
預設值為 true。
實作
public function get autoAdjust():Boolean public function set autoAdjust(value:Boolean):voidbaseAtZero | 屬性 |
baseAtZero:Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Specifies whether Flex tries to keep the minimum
and maximum values rooted at zero.
If all axis values are positive, the minimum axis value is zero.
If all axis values are negative, the maximum axis value is zero.
預設值為 true。
實作
public function get baseAtZero():Boolean public function set baseAtZero(value:Boolean):voidbaseline | 屬性 |
baseline:Number [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The computed minimum value for the axis
as long as this value is greater than 0.
If the maximum value is less than or equal to 0,
then the baseline property is the computed maximum.
If neither value is greater than 0,
then the baseline property is 0.
實作
public function get baseline():NumbercomputedInterval | 屬性 |
protected var computedInterval:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The computed interval represented by this axis.
The computedInterval is used
by the AxisRenderer and Gridlines classes
to determine where to render tick marks and grid lines.
The NumericAxis base class watches this field for changes
to determine if the chart needs to be re-rendered.
Derived classes are responsible for computing the value
of this field.
computedMaximum | 屬性 |
public var computedMaximum:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The computed maximum value represented by this axis.
If the user has explicitly assigned a maximum value,
the computedMaximum and
assignedMaximum properties
are usually the same.
Otherwise, the computedMaximum is generated
from the values represented in the chart.
computedMinimum | 屬性 |
public var computedMinimum:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The computed minimum value represented by this axis.
If the user has explicitly assigned a minimum value,
the computedMinimum and
assignedMinimum properties
are usually be the same.
Otherwise, the computedMinimum is generated
from the values represented in the chart.
dataDescriptions | 屬性 |
dataDescriptions:Array [唯讀] | 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
An Array of DataDescription structures describing the data being represented by the chart. An axis can use this property to generate values for properties, such as its range.
實作
protected function get dataDescriptions():Arraydirection | 屬性 |
direction:String| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 4 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Determines the direction in which the axis is rendered.
Possible values are normal,
and inverted.
All derived classes should take care of the way min and max
are set depending on direction.
All series should take care of the way it is rendered
depending on the direction of its underlying axis.
預設值為 "normal"。
實作
public function get direction():String public function set direction(value:String):voidlabelCache | 屬性 |
protected var labelCache:Array| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The most recent set of AxisLabel objects
generated to represent this axis.
This property is null if the axis
has been modified and requires new labels.
To guarantee that the value of the labelCache property
is correct, call the buildLabelCache() method
before accessing the labelCache property.
labelFunction | 屬性 |
labelFunction:Function| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Called to format axis values for display as labels.
A labelFunction has the following signature:
function function_name(labelValue:Object, previousValue:Object, axis:IAxis):String { ... }
If you know the types of the data your function will be formatting,
you can specify an explicit type for the labelValue
and previousValue parameters.
實作
public function get labelFunction():Function public function set labelFunction(value:Function):voidlabelMaximum | 屬性 |
protected var labelMaximum:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The maximum value where a label should be placed. After computing an adjusted minimum value, many axis types expand the range of the axis further to make room for additional rendering artifacts in the chart, such as labels and borders. This value represents the maximum value in the chart before it is adjusted for these artifacts. Typically axes generate labels to make sure this value is labeled, rather than the adjusted maximum of the axis.
labelMinimum | 屬性 |
protected var labelMinimum:Number| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The minimum value where a label should be placed. After computing an adjusted minimum value, many axis types expand the range of the axis further to make room for additional rendering artifacts in the chart, such as labels and borders. This value represents the minimum value in the chart before it is adjusted for these artifacts. Typically axes will generate labels to make sure this value is labeled, rather than the adjusted minimum of the axis.
minorTickCache | 屬性 |
protected var minorTickCache:Array| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The most recent set of minor tick marks generated to represent this axis.
This property may be null if the axis
has been modified and requires new labels and tick marks.
Use the public accessor minorTicks
to build the minor tick marks on demand.
minorTicks | 屬性 |
padding | 屬性 |
parseFunction | 屬性 |
parseFunction:Function| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Specify a parseFunction to customize how
the values rendered by your chart are converted into numeric values.
A custom parseFunction is passed a data value
and should return a corresponding number representing the same value.
By default, this axis uses the ECMA function parseFloat().
實作
public function get parseFunction():Function public function set parseFunction(value:Function):voidrequiredDescribedFields | 屬性 |
ticks | 屬性 |
NumericAxis | () | 建構函式 |
public function NumericAxis()| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Constructor.
adjustMinMax | () | 方法 |
protected function adjustMinMax(minValue:Number, maxValue:Number):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Adjusts the generated or assigned range of the axis's labels. This method is called during the update cycle of the axis. Subclasses can override this method to do special processing on the values. By default, no adjustments are made to the range.
參數
minValue:Number — The computed minimum value.
| |
maxValue:Number — The computed maximum value.
|
buildLabelCache | () | 方法 |
protected function buildLabelCache():Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Populates the labelCache property with labels representing the current
values of the axis. Subclasses must implement this function. This function is called
many times, so you should check to see if the labelCache property
is null before performing any calculations.
Boolean — true if the labels were regenerated.
|
buildMinorTickCache | () | 方法 |
protected function buildMinorTickCache():Array| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Builds an Array of positions for the minor tick marks Array that is generated by this axis.
Subclasses must implement this function. This function is called automatically
by the NumericAxis. You should access the minorTicks property
instead of calling this function directly.
Array — An Array of positions from 0 to 1 that represent points between the axis
minimum and maximum values where minor tick marks are rendered.
|
filterCache | () | 方法 |
public function filterCache(cache:Array, field:String, filteredField: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.
| |
filteredField: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.
|
guardMinMax | () | 方法 |
protected function guardMinMax(min:Number, max:Number):Array| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Protects the range against invalid values for this axis type. This function is called during the update cycle of the axis to guarantee that invalid ranges are not generated. Subclasses can override this class and define logic that is appropriate to their axis type.
參數
min:Number — The computed minimum value.
| |
max:Number — The computed maximum value.
|
Array — null if no adjustment is necessary, or an Array containing the adjusted
values of the form [min,max].
|
invalidateCache | () | 方法 |
protected function invalidateCache():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Invalidates the cached labels and tick marks that represent this axis's values. Derived classes should call this function whenever values used in the calculation of labels and tick marks change.
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)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.
|
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.
|
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