DataTransform

Pakket	mx.charts.chartClasses
Klasse	public class DataTransform
Overerving	DataTransform EventDispatcher Object
Subklassen	CartesianTransform, PolarTransform

Taalversie:

ActionScript 3.0

Productversie:

Flex 3

Runtimeversies:

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.

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		axes : Object [alleen-lezen] The set of axes associated with this transform.	DataTransform
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		elements : Array The elements that are associated with this transform.	DataTransform

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		DataTransform() Constructor.	DataTransform
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.	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 Verzendt een gebeurtenis naar de gebeurtenisstroom.	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 Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.	EventDispatcher
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	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 Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Verwijdert een listener uit het object EventDispatcher.	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 Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van het opgegeven 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 Retourneert de primitieve waarde van het opgegeven object.	Object
		willTrigger(type:String):Boolean Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.	EventDispatcher

Gebeurtenissen

Klik voor meer informatie over gebeurtenissen.

Overerfde gebeurtenissen verbergen

Overerfde gebeurtenissen weergeven

	Overzicht	Gedefinieerd door
activate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.	EventDispatcher
deactivate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.	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

Eigenschapdetails

axes	eigenschap

axes:Object [alleen-lezen]

Taalversie:

ActionScript 3.0

Productversie:

Flex 3

Runtimeversies:

Flash Player 9, AIR 1.1

The set of axes associated with this transform.

Implementatie
public function get axes():Object

elements

eigenschap

elements:Array

Taalversie:

ActionScript 3.0

Productversie:

Flex 3

Runtimeversies:

Flash Player 9, AIR 1.1

The elements that are associated with this transform. This Array includes background, series, and overlay elements associated with the transform. This value is assigned by the enclosing chart object.

Implementatie
public function get elements():Array
public function set elements(value:Array):void

Constructordetails

()

Constructor

public function DataTransform()

Taalversie:

ActionScript 3.0

Productversie:

Flex 3

Runtimeversies:

Flash Player 9, AIR 1.1

Constructor.

Methodedetails

dataChanged

()

methode

public function dataChanged():void

Taalversie:

ActionScript 3.0

Productversie:

Flex 3

Runtimeversies:

Flash Player 9, AIR 1.1

Informs the DataTransform that some of the underlying data being represented on the chart has changed. The DataTransform generally has no knowledge of the source of the underlying data being represented by the chart, so glyphs should call this when their data changes so that the DataTransform can recalculate range scales based on their data. This does not invalidate the DataTransform, because there is no guarantee the data has changed. The axis objects (or range objects) must trigger an invalidate event.

describeData

()

methode

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

Taalversie:

ActionScript 3.0

Productversie:

Flex 3

Runtimeversies:

Flash Player 9, AIR 1.1

Collects important displayed values for all elements associated with this data transform. Axis instances call this method to collect the values they need to consider when auto-generating appropriate ranges. This method returns an Array of BoundedValue objects.

To collect important values for the horizontal axis of a CartesianTransform, pass 0. To collect values for the vertical axis, pass 1.

Parameters

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

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

Geretourneerde waarde

Array — A Array of BoundedValue objects.

getAxis

()

methode

public function getAxis(dimension:String):IAxis

Taalversie:

ActionScript 3.0

Productversie:

Flex 3

Runtimeversies:

Flash Player 9, AIR 1.1

Retrieves the axis instance responsible for transforming the data dimension specified by the dimension parameter. If no axis has been previously assigned, a default axis is created. The default axis for all dimensions is a LinearAxis with the autoAdjust property set to false.

Parameters

dimension:String — The dimension whose axis is responsible for transforming the data.

Geretourneerde waarde

IAxis — The axis instance.

Verwante API-elementen

mx.charts.LinearAxis

invertTransform

()

methode

public function invertTransform(... values):Array

Taalversie:

ActionScript 3.0

Productversie:

Flex 3

Runtimeversies:

Flash Player 9, AIR 1.1

Transforms x and y coordinates relative to the DataTransform coordinate system into a two-dimensional value in data space.

Parameters

... values — The x and y positions (in that order).

Geretourneerde waarde

Array — An Array containing the transformed values.

setAxis

()

methode

public function setAxis(dimension:String, v:IAxis):void

Taalversie:

ActionScript 3.0

Productversie:

Flex 3

Runtimeversies:

Flash Player 9, AIR 1.1

Assigns an axis instance to a particular dimension of the transform. Axis objects are assigned by the enclosing chart object.

Parameters

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

	`v:IAxis` — The target axis instance.

transformCache

()

methode

 public function transformCache(cache:Array, xField:String, xConvertedField:String, yField:String, yConvertedField:String):void

Taalversie:

ActionScript 3.0

Productversie:

Flex 3

Runtimeversies:

Flash Player 9, AIR 1.1

Maps a set of numeric values representing data to screen coordinates. This method assumes the values are all numbers, so any non-numeric values must have been previously converted with the mapCache() method.

Parameters

	`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.

Gebeurtenisdetails

transformChange

Gebeurtenis

Type gebeurtenisobject: mx.events.FlexEvent
eigenschap FlexEvent.type = mx.events.FlexEvent.TRANSFORM_CHANGE

Taalversie:

ActionScript 3.0

Productversie:

Flex 3

Runtimeversies:

Flash Player 9, AIR 1.1

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.

The FlexEvent.TRANSFORM_CHANGE constant defines the value of the type property of the event object for a transformChange event.

The properties of the event object have the following values:

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.

Juridische kennisgeving | Online privacybeleid

DataTransform - AS3 Flex

Pakkettenx

Taalelementen

Bijlagen

Pakket mx.charts.chartClasses

axes

elements

DataTransform

dataChanged

describeData

getAxis

invertTransform

setAxis

transformCache

transformChange