NumericAxis

包	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

NumericAxis 类作为轴类型的通用基类，此轴类型表示定义的最小值和最大值之间的连续范围。内置的 LinearAxis、LogAxis 和 DateTimeAxis 类都可以扩展此基类。

公共属性

隐藏继承的公共属性

显示继承的公共属性

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

受保护的属性

	属性		由以下参数定义
		assignedMaximum : Number 显式指定的最大值。	NumericAxis
		assignedMinimum : Number 显式指定的最小值。	NumericAxis
		computedInterval : Number 此轴表示的计算间隔。	NumericAxis
		dataDescriptions : Array [只读] 描述图表要显示的数据的 DataDescription 结构 Array。	NumericAxis
		labelCache : Array 用于表示此轴的最新生成的 AxisLabel 对象组。	NumericAxis
		labelMaximum : Number 标签所放位置的最大值。	NumericAxis
		labelMinimum : Number 标签所放位置的最小值。	NumericAxis
		minorTickCache : Array 用于表示此轴的最新生成的刻度线组。	NumericAxis
		requiredDescribedFields : uint [只读] 此轴涉及的 DescribeData 结构字段。	NumericAxis
		ticks : Array [只读] 此轴的刻度线 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, filteredField: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:mx.charts.chartClasses: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
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		transformCache(cache:Array, field:String, convertedField:String):void 将一组来自数据空间的值映射到屏幕空间。	NumericAxis
		unregisterDataTransform(transform:mx.charts.chartClasses: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(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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

assignedMinimum

属性

protected var assignedMinimum:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

autoAdjust

属性

autoAdjust:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

默认值为 true。

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

baseAtZero

属性

baseAtZero:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

默认值为 true。

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

baseline

属性

baseline:Number [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get baseline():Number

computedInterval

属性

protected var computedInterval:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

computedMaximum

属性

public var computedMaximum:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

computedMinimum

属性

public var computedMinimum:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

dataDescriptions

属性

dataDescriptions:Array [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
protected function get dataDescriptions():Array

direction

属性

direction:String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

确定呈示轴的方向。可能的值为 normal 和 inverted。所有派生类都应考虑根据 direction 设置 min 和 max 的方式。所有系列都应考虑根据其基础轴的 direction 呈示它的方式。

默认值为 "normal"。

实现
public function get direction():String
public function set direction(value:String):void

labelCache

属性

protected var labelCache:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

labelFunction

属性

labelFunction:Function

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

调用以设置轴值的格式，使其显示为标签。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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

labelMinimum

属性

protected var labelMinimum:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

minorTickCache

属性

protected var minorTickCache:Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

minorTicks

属性

minorTicks:Array [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get minorTicks():Array

padding

属性

padding:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

parseFunction

属性

parseFunction:Function

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

requiredDescribedFields

属性

requiredDescribedFields:uint [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此轴涉及的 DescribeData 结构字段。

实现
protected function get requiredDescribedFields():uint

ticks

属性

ticks:Array [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此轴的刻度线 Array。

实现
protected function get ticks():Array

构造函数详细信息

()

构造函数

public function NumericAxis()

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。

方法详细信息

adjustMinMax

()

方法

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

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

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

buildLabelCache

()

方法

protected function buildLabelCache():Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

buildMinorTickCache

()

方法

protected function buildMinorTickCache():Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

filterCache

()

方法

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

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

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

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

formatForScreen

()

方法

public function formatForScreen(value:Object):String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

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

String — DataTip 的文本。

getLabelEstimate

()

方法

public function getLabelEstimate():AxisLabelSet

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

AxisLabelSet — AxisLabel 对象的数组。

getLabels

()

方法

public function getLabels(minimumAxisLength:Number):AxisLabelSet

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

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

AxisLabelSet — AxisLabel 对象的数组。

guardMinMax

()

方法

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

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

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

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

invalidateCache

()

方法

protected function invalidateCache():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

invertTransform

()

方法

public function invertTransform(value:Number):Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

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

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

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

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

参数

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

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

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

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

preferDropLabels

()

方法

public function preferDropLabels():Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

reduceLabels

()

方法

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

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

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

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

transformCache

()

方法

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

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

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

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

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

update

()

方法

public function update():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

法律声明 | 在线隐私策略

NumericAxis - AS3 Flex

包x

语言元素

附录

包 mx.charts.chartClasses

assignedMaximum

assignedMinimum

autoAdjust

baseAtZero

baseline

computedInterval

computedMaximum

computedMinimum

dataDescriptions

direction

labelCache

labelFunction

labelMaximum

labelMinimum

minorTickCache

minorTicks

padding

parseFunction

requiredDescribedFields

ticks

NumericAxis

adjustMinMax

buildLabelCache

buildMinorTickCache

filterCache

formatForScreen

getLabelEstimate

getLabels

guardMinMax

invalidateCache

invertTransform

mapCache

preferDropLabels

reduceLabels

transformCache

update