mx.charts.LinearAxis (Flex 3.2)

（仅限 Flex 数据可视化组件）

包	mx.charts
类	public class LinearAxis
继承	LinearAxis NumericAxis AxisBase EventDispatcher Object

LinearAxis 在图表轴的最小值和最大值之间均匀映射数值。默认情况下，它会根据图表数据确定 minimum、maximum 和 interval 值，以适应屏幕上的所有图表元素。您还可以显式为这些属性设置特定值。

按如下方式自动确定范围值：

Flex 确定在图表上显示所有数据所需的最小和最大值。
如果将 autoAdjust 和 baseAtZero 属性设置为 true，则 Flex 将进行如下调整：
- 如果所有值均为正，则 Flex 会将 minimum 属性设置为零。
- 如果所有值均为负，则 Flex 会将 maximum 属性设置为零。
如果将 autoAdjust 属性设置为 true，则 Flex 会通过上下舍入来调整 minimum 和 maximum 属性值。
Flex 检查图表中所显示的任何元素是否需要额外填充才能正常显示（例如标签）。它会对 minimum 和 maximum 属性的值进行相应调整。
Flex 确定您是否就 minimum 和 maximum 值显式指定了填充，并对其值进行相应调整。

MXML 语法

隐藏 MXML 语法

The <mx:LinearAxis> tag inherits all the properties of its parent classes and adds the following properties:

  <mx:LinearAxis
    Properties
    interval="null"
    maximum="null"
    maximumLabelPrecision="null"
    minimum="null"
    minorInterval="null"
  />

查看示例

另请参见

mx.charts.chartClasses.IAxis
About the axis classes
About the NumericAxis class
Adding axis titles
Defining axis labels

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		定义方
		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
		interval : Number 指定轴上各标签值之间的数值差值。	LinearAxis
		labelFunction : Function 调用以设置轴值的格式，使其显示为标签。	NumericAxis
		maximum : Number 指定轴标签的最大值。	LinearAxis
		maximumLabelPrecision : Number 指定在由此轴生成的标签上表示小数值时所用的最大小数位数。	LinearAxis
		minimum : Number 指定轴标签的最小值。	LinearAxis
		minorInterval : Number 指定轴上次刻度线之间的数字差值。	LinearAxis
		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

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		定义方
		LinearAxis() 构造函数。	LinearAxis
		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

属性详细信息

interval

属性

interval:Number [读写]

指定轴上各标签值之间的数值差值。如果将此属性设置为 NaN，则 Flex 将计算间隔。默认值为 NaN。

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

maximum

属性

maximum:Number [读写]

指定轴标签的最大值。如果将 autoAdjust 属性设置为 true，则 Flex 将计算此值。如果为 NaN，则 Flex 将根据图表中的数据确定最大值。默认值为 NaN。

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

maximumLabelPrecision

属性

maximumLabelPrecision:Number [读写]

指定在由此轴生成的标签上表示小数值时所用的最大小数位数。默认情况下，轴会从标签自身自动生成此值。值 0 表示将舍入到最近的整数值，值 2 表示将舍入到与值最接近的百分位值。

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

minimum

属性

minimum:Number [读写]

指定轴标签的最小值。如果此属性为 NaN，则 Flex 将指定图表中的数据的最小值。默认值为 NaN。

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

minorInterval

属性

minorInterval:Number [读写]

指定轴上次刻度线之间的数字差值。如果此属性设置为 NaN，则 Flex 将计算此差值。

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

构造函数详细信息

LinearAxis

()

构造函数

public function LinearAxis()

构造函数。

示例如何使用示例

HLOCChartExample.mxml

<?xml version="1.0"?>
<!-- Simple example to demonstrate the HLOCChart control. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">
    <mx:Script>
        <![CDATA[          
        import mx.collections.ArrayCollection;

        [Bindable]
        private var stockDataAC:ArrayCollection = new ArrayCollection( [
            { Date: "25-Jul", Open: 40.55,  High: 40.75, Low: 40.24, Close:40.31},
            { Date: "26-Jul", Open: 40.15,  High: 40.78, Low: 39.97, Close:40.34},
            { Date: "27-Jul", Open: 40.38,  High: 40.66, Low: 40, Close:40.63},
            { Date: "28-Jul", Open: 40.49,  High: 40.99, Low: 40.3, Close:40.98},
            { Date: "29-Jul", Open: 40.13,  High: 40.4, Low: 39.65, Close:39.95},
            { Date: "1-Aug", Open: 39.00,  High: 39.50, Low: 38.7, Close:38.6}, 
            { Date: "2-Aug", Open: 38.68,  High: 39.34, Low: 37.75, Close:38.84}, 
            { Date: "3-Aug", Open: 38.76,  High: 38.76, Low: 38.03, Close:38.12}, 
            { Date: "4-Aug", Open: 37.98,  High: 37.98, Low: 36.56, Close:36.69},                       
            { Date: "5-Aug", Open: 36.61,  High: 37, Low: 36.48, Close:36.86} ]); 
        ]]>
    </mx:Script>

    <!-- Define custom Stroke for the wick and ticks. -->
    <mx:Stroke id="s1" color="0x000000" weight="5" joints="bevel" caps="square"/>

    <mx:Panel title="HLOCChart Control Example" height="100%" width="100%">
        <mx:HLOCChart id="hlocchart" height="100%" width="100%"
            paddingRight="5" paddingLeft="5" 
            showDataTips="true" dataProvider="{stockDataAC}">
            
            <mx:verticalAxis>
                <mx:LinearAxis id="vaxis" baseAtZero="false" title="Price"/>
            </mx:verticalAxis>

            <mx:horizontalAxis>
                <mx:CategoryAxis id="haxis" categoryField="Date" title="Date"/>
            </mx:horizontalAxis>

            <mx:horizontalAxisRenderers>
                <mx:AxisRenderer axis="{haxis}" canDropLabels="true"/>
            </mx:horizontalAxisRenderers>

            <mx:series>
                <mx:HLOCSeries 
                    openField="Open" 
                    highField="High" 
                    lowField="Low" 
                    closeField="Close"
                    stroke="{s1}"
                    openTickStroke="{s1}"
                    closeTickStroke="{s1}"
                    openTickLength="7"
                    closeTickLength="7"
                />
            </mx:series>
        </mx:HLOCChart>
    </mx:Panel>
</mx:Application>

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