DataTransform

(Preview)

Package	mx.charts.chartClasses
Class	public class DataTransform
Inheritance	DataTransform EventDispatcher Object
Subclasses	CartesianTransform, PolarTransform

Language Version:

ActionScript 3.0

Product Version:

Flex 3

Runtime Versions:

Flash Player 9, AIR 1.1

The DataTransform object represents a portion of a chart that contains glyphs and can transform values to screen coordinates and vice versa. Each DataTransform object has a horizontal axis, a vertical axis, and a set of glyphs (background, data, and overlay) to render.

In theory, a chart can contain multiple overlaid DataTransform objects. This allows you to display a chart with multiple data sets rendered in the same area but with different ranges. For example, you might want to show monthly revenues compared to the number of units sold. If revenue was typically in millions while units was typically in the thousands, it would be difficult to render these effectively along the same range. Overlaying them in different DataTransform objects allows the end user to compare trends in the values when they are rendered with different ranges.

Charts can only contain one set of DataTransform.

Most of the time, you will use the ChartBase object, which hides the existance of the DataTransform object between the chart and its contained glyphs and axis objects. If you create your own ChartElement objects, you must understand the methods of the DataTransform class to correctly implement their element.

Public Properties

Hide Inherited Public Properties

Show Inherited Public Properties

	Property		Defined By
		axes : Object [read-only] The set of axes associated with this transform.	DataTransform
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		elements : Array The elements that are associated with this transform.	DataTransform

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		DataTransform() Constructor.	DataTransform
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.	EventDispatcher
		dataChanged():void Informs the DataTransform that some of the underlying data being represented on the chart has changed.	DataTransform
		describeData(dimension:String, requiredFields:uint):Array Collects important displayed values for all elements associated with this data transform.	DataTransform
		dispatchEvent(event:Event):Boolean Dispatches an event into the event flow.	EventDispatcher
		getAxis(dimension:String):IAxis Retrieves the axis instance responsible for transforming the data dimension specified by the dimension parameter.	DataTransform
		hasEventListener(type:String):Boolean Checks whether the EventDispatcher object has any listeners registered for a specific type of event.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		invertTransform(... values):Array Transforms x and y coordinates relative to the DataTransform coordinate system into a two-dimensional value in data space.	DataTransform
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Removes a listener from the EventDispatcher object.	EventDispatcher
		setAxis(dimension:String, v:IAxis):void Assigns an axis instance to a particular dimension of the transform.	DataTransform
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns the string representation of the specified object.	Object
		transformCache(cache:Array, xField:String, xConvertedField:String, yField:String, yConvertedField:String):void Maps a set of numeric values representing data to screen coordinates.	DataTransform
		valueOf():Object Returns the primitive value of the specified object.	Object
		willTrigger(type:String):Boolean Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.	EventDispatcher

Events

Click for more information on events

Hide Inherited Events

Show Inherited Events

	Summary	Defined By
activate	[broadcast event] Dispatched when the Flash Player or AIR application gains operating system focus and becomes active.	EventDispatcher
deactivate	[broadcast event] Dispatched when the Flash Player or AIR application operating loses system focus and is becoming inactive.	EventDispatcher
transformChange	Dispatched when the transformation from data space to screen space has changed, typically either because the axes that make up the transformation have changed in some way, or the data transform itself has size.	DataTransform

Property Detail

Constructor Detail

Method Detail

Event Detail

[an error occurred while processing this directive]

Legal Notices | Online Privacy Policy

	`cache:Array` — An array of objects containing the data values in their fields. This is also where this function will store the converted numeric values.

	`xField:String` — The field where the data values for the x axis can be found.

	`xConvertedField:String` — The field where the mapped x screen coordinate will be stored.

	`yField:String` — The field where the data values for the y axis can be found.

	`yConvertedField:String` — The field where the mapped y screen coordinate will be stored.

Property	Value
`bubbles`	false
`cancelable`	false
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.

DataTransform - AS3 Flex

Packagesx

Language Elements

Appendixes

Package mx.charts.chartClasses

axes

elements

dataChanged

describeData

getAxis

invertTransform

setAxis

transformCache

transformChange

	`dimension:String` — The dimension to collect values for.

	`requiredFields:uint` — Defines the data that are required by this transform.

	`dimension:String` — The dimension of the transform.

	`v:IAxis` — The target axis instance.