DataTransform

Package	mx.charts.chartClasses
Classe	public class DataTransform
Héritage	DataTransform EventDispatcher Object
Sous-classes	CartesianTransform, PolarTransform

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

L’objet DataTransform représente une partie de graphique contenant des glyphes. Il peut transformer des valeurs en coordonnées d’écran et vice-versa. Chaque objet DataTransform contient un axe horizontal, un axe vertical et un ensemble de glyphes à rendre (arrière-plan, données et incrustation).

Un graphique peut théoriquement contenir plusieurs objets DataTransform superposés. Vous pouvez ainsi afficher un graphique dans lequel plusieurs jeux de données utilisant différentes plages de valeurs sont rendus dans une même zone. Supposons que vous souhaitez afficher les recettes mensuelles et comparer cette valeur au nombre de produits vendus. Si les recettes sont généralement exprimées en millions et le nombre de produits vendus en milliers, il est difficile de rendre ces valeurs de façon efficace en utilisant une même plage de valeurs. En utilisant plusieurs objets DataTransform pour réaliser une incrustation et rendre les valeurs à l’aide de plages différentes, l’utilisateur final peut comparer l’évolution des valeurs.

Un graphique peut contenir un seul ensemble d’objets DataTransform.

La plupart du temps, vous utiliserez l’objet ChartBase, qui masque l’existence de l’objet DataTransform entre le graphique et les objets de glyphe et d’axe qu’il contient. Si vous créez vos propres objets ChartElement, vous devez comprendre les méthodes de la classe DataTransform pour implémenter correctement leur élément.

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		axes : Object [lecture seule] Ensemble d’axes associé à cette transformation.	DataTransform
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		elements : Array Eléments associés à cette transformation.	DataTransform

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		DataTransform() Constructeur.	DataTransform
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	EventDispatcher
		dataChanged():void Signale à l’objet DataTransform qu’une partie des données sous-jacentes représentées dans le graphique a changé.	DataTransform
		describeData(dimension:String, requiredFields:uint):Array Collecte les valeurs affichées importantes pour tous les éléments associés à cette transformation de données.	DataTransform
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		getAxis(dimension:String):IAxis Extrait l’instance d’axe chargée de transformer la dimension de données spécifiée par le paramètre dimension.	DataTransform
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		invertTransform(... values):Array Transforme les coordonnées x et y en une valeur à deux dimensions dans l’espace de données, par rapport au système de coordonnées DataTransform.	DataTransform
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		setAxis(dimension:String, v:IAxis):void Affecte une instance d’axe à une dimension spécifique de la transformation.	DataTransform
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		transformCache(cache:Array, xField:String, xConvertedField:String, yField:String, yConvertedField:String):void Mappe à des coordonnées d’écran un ensemble de valeurs numériques représentant des coordonnées.	DataTransform
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	EventDispatcher

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
transformChange	Distribué lorsque la transformation d’un espace de données en espace d’écran a changé, généralement parce que les axes réalisant la transformation ont été modifiés ou parce qu’une taille a été affectée à la transformation de données.	DataTransform

Détails de la propriété

axes

propriété

axes:Object [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Ensemble d’axes associé à cette transformation.

Implémentation
public function get axes():Object

elements

propriété

elements:Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Eléments associés à cette transformation. Ce tableau contient les éléments d’arrière-plan, de série et d’incrustation associés à la transformation. Cette valeur est affectée par l’objet de graphique conteneur.

Implémentation
public function get elements():Array
public function set elements(value:Array):void

Détails du constructeur

()

Constructeur

public function DataTransform()

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Constructeur.

Détails de la méthode

dataChanged

()

méthode

public function dataChanged():void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Signale à l’objet DataTransform qu’une partie des données sous-jacentes représentées dans le graphique a changé. En général, l’objet DataTransform ne dispose d’aucune information sur la source des données sous-jacentes représentées par le graphique. Par conséquent, les glyphes doivent appeler cette méthode lorsque leurs données changent, de sorte que l’objet DataTransform puisse calculer à nouveau les échelles de plage de valeurs, en fonction des données. L’objet DataTransform n’est pas invalidé pour autant, car il n’est pas certain que les données aient réellement changé. Les objets d’axe (ou de plage de valeurs) doivent déclencher un événement d’invalidation.

describeData

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Collecte les valeurs affichées importantes pour tous les éléments associés à cette transformation de données. Les instances d’axe appellent cette méthode pour collecter les valeurs qu’elles doivent prendre en compte pour générer automatiquement les plages de valeurs appropriées. Cette méthode renvoie un tableau d’objets BoundedValue.

Pour collecter les valeurs importantes pour l’axe horizontal d’un objet CartesianTransform, transmettez la valeur 0. Pour collecter les valeurs pour l’axe vertical, transmettez la valeur 1.

Paramètres

	`dimension:String` — Dimension pour laquelle des valeurs doivent être collectées.

	`requiredFields:uint` — Définit les données requises par cette transformation.

Valeur renvoyée

Array — Tableau d’objets BoundedValue.

getAxis

()

méthode

public function getAxis(dimension:String):IAxis

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Extrait l’instance d’axe chargée de transformer la dimension de données spécifiée par le paramètre dimension. Si aucun axe n’a été affecté précédemment, un axe par défaut est créé. L’axe par défaut de toutes les dimensions est un objet LinearAxis dont la propriété autoAdjust est définie sur false.

Paramètres

dimension:String — Dimension dont l’axe est chargé de transformer les données.

Valeur renvoyée

IAxis — Instance d’axe.

Eléments de l’API associés

mx.charts.LinearAxis

invertTransform

()

méthode

public function invertTransform(... values):Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Transforme les coordonnées x et y en une valeur à deux dimensions dans l’espace de données, par rapport au système de coordonnées DataTransform.

Paramètres

... values — Positions x et y (dans cet ordre).

Valeur renvoyée

Array — Tableau contenant les valeurs transformées.

setAxis

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Affecte une instance d’axe à une dimension spécifique de la transformation. Les objets d’axe sont affectés par l’objet de graphique conteneur.

Paramètres

	`dimension:String` — Dimension de la transformation.

	`v:IAxis` — Instance d’axe cible.

transformCache

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Mappe à des coordonnées d’écran un ensemble de valeurs numériques représentant des données. Cette méthode suppose que toutes les valeurs sont des nombres. Par conséquent, toute valeur non numérique doit au préalable être convertie à l’aide de la méthode mapCache().

Paramètres

	`cache:Array` — Tableau d’objets dont les champs contiennent les valeurs de données. C’est également dans ce tableau que la fonction stocke les valeurs numériques converties.

	`xField:String` — Champ dans lequel se trouvent les valeurs de données pour l’axe x.

	`xConvertedField:String` — Champ dans lequel se trouve la coordonnée d’écran x mappée.

	`yField:String` — Champ dans lequel se trouvent les valeurs de données pour l’axe y.

	`yConvertedField:String` — Champ dans lequel se trouve la coordonnée d’écran y mappée.

Détails de l’événement

transformChange

Evénement

Type d’objet d’événement: mx.events.FlexEvent
propriété FlexEvent.type = mx.events.FlexEvent.TRANSFORM_CHANGE

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Distribué lorsque la transformation d’un espace de données en espace d’écran a changé, généralement parce que les axes réalisant la transformation ont été modifiés ou parce qu’une taille a été affectée à la transformation de données.

La constante FlexEvent.TRANSFORM_CHANGE définit la valeur de la propriété type de l’objet d’événement d’un événement transformChange.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

Propriété	Valeur
`bubbles`	false
`cancelable`	false
`currentTarget`	Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez `myButton.addEventListener()` pour enregistrer un écouteur d’événement, myButton est la valeur de `currentTarget`.
`target`	Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété `currentTarget`.

Informations juridiques | Politique de confidentialité en ligne

DataTransform - AS3 Flex

Classes x

axes

elements

DataTransform

dataChanged

describeData

getAxis

invertTransform

setAxis

transformCache

transformChange