IChartElement - Adobe ActionScript® 3 (AS3 Flex) API 参考

包	mx.charts.chartClasses
接口	public interface IChartElement extends IFlexDisplayObject , IBitmapDrawable , IEventDispatcher

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

IChartElement 定义在图表的数据空间中显示 UIComponent 所需的一组基本属性和方法。分配到此系列的任何组件（图表的 backgroundElement 或者 annotationElement 数组）都必须实现此接口。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		accessibilityProperties : AccessibilityProperties 此显示对象的当前辅助功能选项。	IFlexDisplayObject
		alpha : Number 表示指定对象的 Alpha 透明度值。	IFlexDisplayObject
		blendMode : String BlendMode 类中的一个值，用于指定要使用的混合模式。	IFlexDisplayObject
		cacheAsBitmap : Boolean 如果设置为 true，则 Flash 运行时将缓存显示对象的内部位图表示形式。	IFlexDisplayObject
		chartDataProvider : Object [只写] 分配给封闭图表的数据提供程序。	IChartElement
		dataTransform : mx.charts.chartClasses:DataTransform [只写] 元素在数据和屏幕坐标之间进行映射使用的 DataTransform 对象。	IChartElement
		filters : Array 包含当前与显示对象关联的每个滤镜对象的索引数组。	IFlexDisplayObject
		height : Number 表示显示对象的高度，以像素为单位。	IFlexDisplayObject
		labelContainer : Sprite [只读] 用于显示由此元素显示的标签的 DisplayObject。	IChartElement
		loaderInfo : LoaderInfo [只读] 返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。	IFlexDisplayObject
		mask : DisplayObject 调用显示对象被指定的 mask 对象遮罩。	IFlexDisplayObject
		measuredHeight : Number [只读] 此对象的测量高度。	IFlexDisplayObject
		measuredWidth : Number [只读] 此对象的测量宽度。	IFlexDisplayObject
		mouseX : Number [只读] 表示此鼠标或用户输入设备位置的 x 坐标，以像素为单位。	IFlexDisplayObject
		mouseY : Number [只读] 表示此鼠标或用户输入设备位置的 y 坐标，以像素为单位。	IFlexDisplayObject
		name : String 表示 DisplayObject 的实例名称。	IFlexDisplayObject
		opaqueBackground : Object 指定显示对象是否由于具有某种背景颜色而不透明。	IFlexDisplayObject
		parent : DisplayObjectContainer [只读] 表示包含此显示对象的 DisplayObjectContainer 对象。	IFlexDisplayObject
		root : DisplayObject [只读] 对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。	IFlexDisplayObject
		rotation : Number 表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。	IFlexDisplayObject
		scale9Grid : Rectangle 当前有效的缩放网格。	IFlexDisplayObject
		scaleX : Number 表示从注册点开始应用的对象的水平缩放比例（百分比）。	IFlexDisplayObject
		scaleY : Number 表示从对象注册点开始应用的对象的垂直缩放比例（百分比）。	IFlexDisplayObject
		scrollRect : Rectangle 显示对象的滚动矩形范围。	IFlexDisplayObject
		stage : Stage [只读] 显示对象的舞台。	IFlexDisplayObject
		transform : flash.geom:Transform 一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。	IFlexDisplayObject
		visible : Boolean 显示对象是否可见。	IFlexDisplayObject
		width : Number 表示显示对象的宽度，以像素为单位。	IFlexDisplayObject
		x : Number 表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 x 坐标。	IFlexDisplayObject
		y : Number 表示 DisplayObject 实例相对于父级 DisplayObjectContainer 本地坐标的 y 坐标。	IFlexDisplayObject

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	IEventDispatcher
		chartStateChanged(oldState:uint, v:uint):void 封闭图表调用此方法来指示该图表的当前状态已更改。	IChartElement
		claimStyles(styles:Array, firstAvailable:uint):uint 图表调用此方法来允许相关元素声明其 chartSeriesStyles Array 中的样式选择器。	IChartElement
		collectTransitions(chartState:Number, transitions:Array):void 封闭图表调用此方法来收集特定元素在图表状态发生更改时可能执行的任何过渡。	IChartElement
		describeData(dimension:String, requiredFields:uint):Array 由具有控制地位的 DataTransform 调用，以获得由此 IChartElement 表示的数据描述。	IChartElement
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	IEventDispatcher
		findDataPoints(x:Number, y:Number, sensitivity2:Number):Array 返回一个 HitData 对象，用于描述距离传递给方法的坐标位置最近的数据点。	IChartElement
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。	IFlexDisplayObject
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。	IFlexDisplayObject
		globalToLocal(point:Point):Point 将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。	IFlexDisplayObject
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	IEventDispatcher
		hitTestObject(obj:DisplayObject):Boolean 计算显示对象的边框，以确定它是否与 obj 显示对象的边框重叠或相交。	IFlexDisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean 计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。	IFlexDisplayObject
		localToGlobal(point:Point):Point 将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。	IFlexDisplayObject
		mappingChanged():void 向元素指示相关轴的数据映射已更改。	IChartElement
		move(x:Number, y:Number):void 将此对象移动到指定的 x 和 y 坐标。	IFlexDisplayObject
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	IEventDispatcher
		setActualSize(newWidth:Number, newHeight:Number):void 设置此对象的实际大小。	IFlexDisplayObject
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	IEventDispatcher

属性详细信息

chartDataProvider

属性

chartDataProvider:Object [只写]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

分配给封闭图表的数据提供程序。必要时，元素类型可以选择从封闭图表中继承数据提供程序，或者允许开发人员专门为此元素指定数据提供程序。并非所有元素都必须由数据提供程序驱动。

实现
public function set chartDataProvider(value:Object):void

dataTransform

属性

dataTransform:mx.charts.chartClasses:DataTransform [只写]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

元素在数据和屏幕坐标之间进行映射使用的 DataTransform 对象。此属性由封闭图表分配。

实现
public function set dataTransform(value:mx.charts.chartClasses:DataTransform):void

labelContainer

属性

labelContainer:Sprite [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

用于显示由此元素显示的标签的 DisplayObject。在多数情况下，在图表的数据区域中显示的标签显示在所有元素上方，而不是插入到数据中。如果正在实现的元素存在要显示的标签，则可以将其放置在 Sprite 对象中，并将其作为 labelContainer 属性的值返回。封闭图表将从所有封闭的元素中呈示 labelContainer，并将其放在数据区域中所有其他元素的上方。

实现
public function get labelContainer():Sprite

方法详细信息

chartStateChanged

()

方法

public function chartStateChanged(oldState:uint, v:uint):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

封闭图表调用此方法来指示该图表的当前状态已更改。实现元素应该响应此方法，以同步对由元素显示的数据所做的更改。

参数

	`oldState:uint` — 一个表示上一状态的整数。

	`v:uint` — 一个表示新状态的整数。

claimStyles

()

方法

public function claimStyles(styles:Array, firstAvailable:uint):uint

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

图表调用此方法来允许相关元素声明其 chartSeriesStyles Array 中的样式选择器。每个图表都有一组相关的选择器，这些选择器被隐式分配给图表中包含的需要它们的元素中。实现此函数可以使元素根据需要“声明”该组中的元素。需要 N 个样式选择器的元素声明值介于 styles[firstAvailable] 和 styles[firstAvailable + N - 1] 之间。

参数

	`styles:Array` — 要声明的样式 Array。

	`firstAvailable:uint` — 要声明的样式 Array 中的第一个样式选择器。

uint — 声明任何样式（例如 firstAvailable + N）之后 firstAvailable 的新值。

collectTransitions

()

方法

public function collectTransitions(chartState:Number, transitions:Array):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

封闭图表调用此方法来收集特定元素在图表状态发生更改时可能执行的任何过渡。图表将收集所有元素的过渡，并确保这些过渡并行执行。此图表等待所有过渡完成之后，才会进入另一个状态。实现器应将所有的必要过渡追加到过渡 Array 参数。

参数

	`chartState:Number` — 图表执行新过渡时的状态。

	`transitions:Array` — 要添加到图表要执行的过渡列表中的过渡 Array。

describeData

()

方法

public function describeData(dimension:String, requiredFields:uint):Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

由具有控制地位的 DataTransform 调用，以获得由此 IChartElement 表示的数据描述。实现器填充并返回 mx.charts.chartClasses.DataDescription 对象 Array，以保证它们的数据能够按任一条轴进行正确显示，而这里的轴是根据所显示的数据（如最小值、最大值、间隔和单位大小）自动生成值的。多数元素类型都会返回包含一个 DataDescription 的 Array。聚合元素（如 BarSet 和 ColumnSet）可能会返回多个 DataDescription 实例，用于描述由其子元素显示的数据。调用此方法时，实现器会沿 dimension 参数说明的轴显示数据。对于所包含的图表支持的每条轴，都有可能调用此函数。

参数

	`dimension:String` — 确定从中获取数据描述的轴。

	`requiredFields:uint` — 一个位域，指示特定轴需要关注 DataDescription 对象的哪些值。实现器通过仅计算必要字段即可实现优化。

Array — 一个 Array，其中包含用于描述显示数据的 DataDescription 实例。

findDataPoints

()

方法

public function findDataPoints(x:Number, y:Number, sensitivity2:Number):Array

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回一个 HitData 对象，用于描述距离传递给方法的坐标位置最近的数据点。x 和 y 参数应为元素坐标系中的值。寻找附近数据点的过程中，此方法遵守由 sensitivity2 参数指定的限制。

参数

	`x:Number` — 关于 ChartBase 对象的 x 坐标。

	`y:Number` — 关于 ChartBase 对象的 y 坐标。

	`sensitivity2:Number` — 距 x/y 坐标位置所示数据点的最大距离。

Array — 描述 sensitivity2 像素内最近数据点的 HitData 对象。

mappingChanged

()

方法

public function mappingChanged():void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

向元素指示相关轴的数据映射已更改。实现器应处理缓存的数据并适当地进行重新显示。如果需要，相关联的 DataTransform 将自动调用此函数。

法律声明 | 在线隐私策略

IChartElement - AS3 Flex

类 x

chartDataProvider

dataTransform

labelContainer

chartStateChanged

claimStyles

collectTransitions

describeData

findDataPoints

mappingChanged