mx.charts.chartClasses.NumericAxis (Flex 3.2)

	属性	定义方
		autoAdjust : Boolean 指定 Flex 是否舍入值。	NumericAxis
		baseAtZero : Boolean 指定 Flex 是否尝试保持最小值和最大值基于零。	NumericAxis
		baseline : Number [只读 (read-only)] 只要此值大于 0，则为此轴的最小计算值。	NumericAxis
		chartDataProvider : Object [只写] 分配给封闭图表的数据提供程序。	AxisBase
		computedMaximum : Number 此轴表示的最大计算值。	NumericAxis
		computedMinimum : Number 此轴表示的最小计算值。	NumericAxis
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		displayName : String 轴的名称。	AxisBase
		labelFunction : Function 调用以设置轴值的格式，使其显示为标签。	NumericAxis
		minorTicks : Array [只读 (read-only)] 用于表示此轴的生成的次要刻度线 Array。	NumericAxis
		padding : Number 在屏幕上显示值时，指定 Flex 添加到轴的最小计算值和最大计算值的填充。	NumericAxis
		parseFunction : Function 指定 parseFunction 以自定义如何将图表中呈现的值转换成数值。	NumericAxis
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		title : String 沿该轴显示的标题文本。	AxisBase
		unitSize : Number [只读 (read-only)] 由该轴表示的一个数据单位大小。	AxisBase

	属性	定义方
		assignedMaximum : Number 显式指定的最大值。	NumericAxis
		assignedMinimum : Number 显式指定的最小值。	NumericAxis
		computedInterval : Number 此轴表示的计算间隔。	NumericAxis
		dataDescriptions : Array [只读 (read-only)] 描述图表要显示的数据的 DataDescription 结构 Array。	NumericAxis
		labelCache : Array 用于表示此轴的最新生成的 AxisLabel 对象组。	NumericAxis
		labelMaximum : Number 标签所放位置的最大值。	NumericAxis
		labelMinimum : Number 标签所放位置的最小值。	NumericAxis
		minorTickCache : Array 用于表示此轴的最新生成的刻度线组。	NumericAxis
		requiredDescribedFields : uint [只读 (read-only)] 此轴涉及的 DescribeData 结构字段。	NumericAxis
		ticks : Array [只读 (read-only)] 此轴的刻度线 Array。	NumericAxis

	方法	定义方
		NumericAxis() 构造函数。	NumericAxis
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dataChanged():void 在图表数据更改时触发通知范围对象的事件。	AxisBase
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		filterCache(cache:Array, field:String, filteredString:String):void 将任意类型的一组值过滤为可以映射的一组数字。	NumericAxis
		formatForScreen(value:Object):String 格式化值以便在 DataTip 中显示。	NumericAxis
		getLabelEstimate():AxisLabelSet 确定范围以估计轴标签的内容。	NumericAxis
		getLabels(minimumAxisLength:Number):AxisLabelSet 获取显示的标签文本。	NumericAxis
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		invertTransform(value:Number):Object 沿轴将一个位置映射回数字数据值。	NumericAxis
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		mapCache(cache:Array, field:String, convertedField:String, indexValues:Boolean = false):void 将任意类型的一组值转换为一组可以转换为屏幕坐标的数字。	NumericAxis
		preferDropLabels():Boolean 确定轴处理重叠标签的方式。	NumericAxis
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		reduceLabels(intervalStart:AxisLabel, intervalEnd:AxisLabel):AxisLabelSet 当在不发生重叠的情况下 AxisRenderer 无法清楚地显示标签时调用，像 Axis 对象减少标签组中标签的数目一样。	NumericAxis
		registerDataTransform(transform:DataTransform, dimensionName:String):void 使用轴的每个 DataTransform 都将自身注册到该轴。	AxisBase
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		transformCache(cache:Array, field:String, convertedField:String):void 将一组来自数据空间的值映射到屏幕空间。	NumericAxis
		unregisterDataTransform(transform:DataTransform):void 使用轴的每个 DataTransform 都将自身注册到该轴。	AxisBase
		update():void 更新图表。	NumericAxis
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

	方法	定义方
		adjustMinMax(minValue:Number, maxValue:Number):void 调整轴标签的生成范围或分配范围。	NumericAxis
		buildLabelCache():Boolean 使用表示轴当前值的标签填充 labelCache 属性。	NumericAxis
		buildMinorTickCache():Array 为此轴生成的次要刻度线数组构建位置 Array。	NumericAxis
		describeData(dimension:String, requiredFields:uint):Array 由具有控制地位的 DataTransform 调用，以获得由此 IChartElement 表示的数据描述。	AxisBase
		guardMinMax(min:Number, max:Number):Array 保护此范围，以防使用对此轴类型无效的值。	NumericAxis
		invalidateCache():void 使表示此轴值的缓存标签和刻度线失效。	NumericAxis

	事件	摘要	定义方
		activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
		deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher

属性详细信息

assignedMaximum

属性

protected var assignedMaximum:Number

显式指定的最大值。如果未指定任何值，则为 NaN。通常，应使用 computedMaximum 字段执行计算。

assignedMinimum

属性

protected var assignedMinimum:Number

显式指定的最小值。如果未指定任何值，则为 NaN。通常，应使用 computedMinimum 字段执行计算。

autoAdjust

属性

autoAdjust:Boolean [读写]

指定 Flex 是否舍入值。如果为 false，则 Flex 不会舍入由 minimum 和 maximum 属性设置的值，也不会修改默认的 minimum 和 maximum 值。

默认值为 true.

实现
public function get autoAdjust():Boolean
public function set autoAdjust(value:Boolean):void

baseAtZero

属性

baseAtZero:Boolean [读写]

指定 Flex 是否尝试保持 minimum 和 maximum 基于零。如果所有轴值都是正值，则轴的最小值为零。如果所有轴值都是负值，则轴的最大值为零。

默认值为 true.

实现
public function get baseAtZero():Boolean
public function set baseAtZero(value:Boolean):void

baseline

属性

baseline:Number [只读 (read-only)]

只要此值大于 0，则为此轴的最小计算值。如果最大值小于等于 0，则 baseline 属性为最大计算值。如果两个值都不小于 0，则 baseline 属性为 0。

实现
public function get baseline():Number

computedInterval

属性

protected var computedInterval:Number

此轴表示的计算间隔。AxisRenderer 和 Gridlines 类使用 computedInterval 来确定呈现刻度线和网格线的位置。NumericAxis 基类查看此字段的更改以确定是否需要重新呈现此图表。派生类负责计算此字段的值。

computedMaximum

属性

public var computedMaximum:Number

此轴表示的最大计算值。如果用户已显式指定最大值，则通常 computedMaximum 和 assignedMaximum 属性相同。否则，由在图表中表示的值生成 computedMaximum。

computedMinimum

属性

public var computedMinimum:Number

此轴表示的最小计算值。如果用户已显式指定最小值，则通常 computedMinimum 和 assignedMinimum 属性相同。否则，由在图表中表示的值生成 computedMinimum。

dataDescriptions

属性

dataDescriptions:Array [只读 (read-only)]

描述图表要显示的数据的 DataDescription 结构 Array。轴可以使用此属性为属性生成值，如属性范围。

实现
protected function get dataDescriptions():Array

labelCache

属性

protected var labelCache:Array

用于表示此轴的最新生成的 AxisLabel 对象组。如果轴已修改并且需要新的标签，则属性为 null。要保证 labelCache 属性的值正确，请在访问 labelCache 属性前调用 buildLabelCache() 方法。

labelFunction

属性

labelFunction:Function [读写]

调用以设置轴值的格式，使其显示为标签。labelFunction 包含以下签名：

            function
            function_name
            (
            labelValue
            :Object,
            previousValue
            :Object,
            axis
            :IAxis):String { ... }

如果知道函数要设置其格式的数据类型，则可以指定 labelValue 和 previousValue 参数的显式类型。

实现
public function get labelFunction():Function
public function set labelFunction(value:Function):void

labelMaximum

属性

protected var labelMaximum:Number

标签所放位置的最大值。计算出调整的最小值后，许多轴类型会进一步扩展轴范围以容纳图表中显示的其它项目（如标签和边框）。在针对这些项目进行调整之前，此值表示图表中的最大值。通常轴会生成标签以确保标记了此值，而不是调整轴的最大值。

labelMinimum

属性

protected var labelMinimum:Number

标签所放位置的最小值。计算出调整的最小值后，许多轴类型会进一步扩展轴范围以容纳图表中显示的其它项目（如标签和边框）。在针对这些项目进行调整之前，此值表示图表中的最小值。通常轴会生成标签以确保标记了此值，而不是调整轴的最小值。

minorTickCache

属性

protected var minorTickCache:Array

用于表示此轴的最新生成的刻度线组。如果轴已修改并且需要新的标签和刻度线，则属性为 null。使用公共存取器 minorTicks 来构建所需的次要刻度线。

minorTicks

属性

minorTicks:Array [只读 (read-only)]

用于表示此轴的生成的次要刻度线 Array。

实现
public function get minorTicks():Array

padding

属性

padding:Number [读写]

在屏幕上显示值时，指定 Flex 添加到轴的最小计算值和最大计算值的填充。

实现
public function get padding():Number
public function set padding(value:Number):void

parseFunction

属性

parseFunction:Function [读写]

指定 parseFunction 以自定义如何将图表中呈现的值转换成数值。自定义 parseFunction 传递数据值，应返回表示相同值的相应数字。默认情况下，此轴使用 ECMA 函数 parseFloat()。

实现
public function get parseFunction():Function
public function set parseFunction(value:Function):void

requiredDescribedFields

属性

requiredDescribedFields:uint [只读 (read-only)]

此轴涉及的 DescribeData 结构字段。

实现
protected function get requiredDescribedFields():uint

ticks

属性

ticks:Array [只读 (read-only)]

此轴的刻度线 Array。

实现
protected function get ticks():Array

构造函数详细信息

NumericAxis

()

构造函数

public function NumericAxis()

构造函数。

方法详细信息

adjustMinMax

()

方法

protected function adjustMinMax(minValue:Number, maxValue:Number):void

调整轴标签的生成范围或分配范围。在轴的更新周期中调用此方法。子类可以覆盖此方法以对值进行特殊处理。默认情况下，不会对此范围进行任何调整。

参数

	`minValue:Number` — 计算的最小值。

	`maxValue:Number` — 计算的最大值。

buildLabelCache

()

方法

protected function buildLabelCache():Boolean

使用表示轴当前值的标签填充 labelCache 属性。子类必须实现此函数。此函数将被多次调用，因此应始终在执行计算前检查 labelCache 属性是否为 null。

Boolean — 如果重新生成标签，则为 true。

buildMinorTickCache

()

方法

protected function buildMinorTickCache():Array

为此轴生成的次要刻度线数组构建位置 Array。子类必须实现此函数。NumericAxis 自动调用此函数。应该访问 minorTicks 属性，而不是直接调用此函数。

Array — 0 和 1 之间的位置 Array 表示在轴最小值和最大值之间呈现次要刻度线的点。

filterCache

()

方法

public function filterCache(cache:Array, field:String, filteredString:String):void

将任意类型的一组值过滤为可以映射的一组数字。

参数

	`cache:Array` — 可从中读取和存储转换后的值的对象数组。

	`field:String` — 包含过滤之前的值的缓存 Array 中所含的对象域。

	`filteredString:String` — 存储过滤后的值的缓存 Array 中所含的对象域。

formatForScreen

()

方法

public function formatForScreen(value:Object):String

格式化值以便在 DataTip 中显示。返回用户可读的字符串。

参数

value:Object — 转换为 String 类型的值。

String — DataTip 的文本。

getLabelEstimate

()

方法

public function getLabelEstimate():AxisLabelSet

确定范围以估计轴标签的内容。轴几乎立即调用 getLabels() 方法以获取真实值。轴使用估计的值调整图表边距，因此只要估计的标签和实际标签（由 getLabels() 方法返回）间存在差别，就会调整标签以满足要求。

当返回估计值时，轴只需返回最小和最大标签。如果标签组完全是静态的，不会根据轴大小在屏幕上显示，则轴可通过此函数返回整个标签组，并将估计值标记为准确值。

AxisLabelSet — 一个 AxisLabel 对象 Array。

getLabels

()

方法

public function getLabels(minimumAxisLength:Number):AxisLabelSet

获取显示的标签文本。当 Flex 调用此方法时，轴已确定标签的最小长度。

参数

minimumAxisLength:Number — 轴的最小长度（以像素为单位）。轴长可以大于此值，但不可以小于此值。

AxisLabelSet — 一个 AxisLabel 对象数组。

guardMinMax

()

方法

protected function guardMinMax(min:Number, max:Number):Array

保护此范围，以防使用对此轴类型无效的值。在轴的更新周期中调用此函数以保证不会生成无效的范围。子类可以覆盖此类并定义适合其轴类型的逻辑。

参数

	`min:Number` — 计算的最小值。

	`max:Number` — 计算的最大值。

Array — 如果不需要进行调整则为 null，或者包含 [min,max] 格式的调整值的 Array。

invalidateCache

()

方法

protected function invalidateCache():void

使表示此轴值的缓存标签和刻度线失效。每当标签和刻度线计算中使用的值发生更改时，派生类都应调用此函数。

invertTransform

()

方法

public function invertTransform(value:Number):Object

沿轴将一个位置映射回数字数据值。

参数

value:Number — 轴的范围。此参数应介于 0 和 1 之间，0 表示轴的下限，1 表示轴的上限。

Object — 包含转换后的值的对象。

mapCache

()

方法

public function mapCache(cache:Array, field:String, convertedField:String, indexValues:Boolean = false):void

将任意类型的一组值转换为一组可以转换为屏幕坐标的数字。

参数

	`cache:Array` — 可从中读取和存储转换后的值的对象数组。

	`field:String` — 包含转换之前的值的缓存 Array 中所含的对象域。

	`convertedField:String` — 存储转换后的值的缓存 Array 中所含的对象域。

	`indexValues:Boolean` (default = `false`) — 如果要映射的值是索引值，则此参数为 `true`；如果这些值是自然数据值，则此参数为 `false`。

preferDropLabels

()

方法

public function preferDropLabels():Boolean

确定轴处理重叠标签的方式。通常，数字范围返回 true，而基于离散值的范围不返回此值。您可以通过直接在轴上设置此属性来覆盖此属性。

Boolean — 如果可以在不丢失数据的情况下删除标签，则为 true；否则为 false。

reduceLabels

()

方法

public function reduceLabels(intervalStart:AxisLabel, intervalEnd:AxisLabel):AxisLabelSet

当在不发生重叠的情况下 AxisRenderer 无法清楚地显示标签时调用，像 Axis 对象减少标签组中标签的数目一样。此方法传递重叠的两个标签。

参数

	`intervalStart:AxisLabel` — 标签重叠处间隔的开始位置。

	`intervalEnd:AxisLabel` — 标签重叠处间隔的结束位置。

AxisLabelSet — 通过减少标签的数目来解决重叠问题的新标签组。

transformCache

()

方法

public function transformCache(cache:Array, field:String, convertedField:String):void

将一组来自数据空间的值映射到屏幕空间。

参数

	`cache:Array` — 可从中读取和存储映射后的值的对象 Array。

	`field:String` — 包含映射之前的值的缓存 Array 中所含的对象域。

	`convertedField:String` — 存储映射后的值的缓存 Array 中所含的对象域。

update

()

方法

public function update():void

更新图表。可在每个帧中多次调用此方法。

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
NumericAxis	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例

包	mx.charts.chartClasses
类	public class NumericAxis
继承	NumericAxis AxisBase EventDispatcher Object
实现	IAxis
子类	DateTimeAxis, LinearAxis, LogAxis