| 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 |
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.
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éthode | Défini par | ||
|---|---|---|---|
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 | |
Signale à l’objet DataTransform qu’une partie des données sous-jacentes représentées dans le graphique a changé. | DataTransform | ||
Collecte les valeurs affichées importantes pour tous les éléments associés à cette transformation de données. | DataTransform | ||
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
Extrait l’instance d’axe chargée de transformer la dimension de données spécifiée par le paramètre dimension. | DataTransform | ||
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
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 | ||
|
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 | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
Affecte une instance d’axe à une dimension spécifique de la transformation. | DataTransform | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
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 | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
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énement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| 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 | |||
axes | propriété |
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):voidDataTransform | () | 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.
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.
|
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.
|
IAxis — Instance d’axe.
|
Eléments de l’API associés
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).
|
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.
|
transformChange | Evénement |
mx.events.FlexEventproprié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 constanteFlexEvent.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. |
Tue Jun 12 2018, 09:30 AM Z