Package | mx.charts.chartClasses |
Interface | public interface IAxis extends IEventDispatcher |
Implémenteurs | CategoryAxis, NumericAxis |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Les classes implémentent cette interface pour fournir des fonctionnalités de définition de plage de valeurs.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
baseline : Number [lecture seule]
Position de la ligne de base de l’axe. | IAxis | ||
chartDataProvider : Object [écriture seule]
Fournisseur de données affecté au graphique conteneur. | IAxis | ||
displayName : String [lecture seule]
Nom de l’axe. | IAxis | ||
title : String [lecture seule]
Texte du titre affiché le long de l’axe. | IAxis | ||
unitSize : Number [lecture seule]
Taille d’une unité de données représentée par cet axe. | IAxis |
Méthode | Défini par | ||
---|---|---|---|
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. | IEventDispatcher | ||
Déclenche des événements qui signalent à l’objet de plage de valeurs que les données du graphique ont changé. | IAxis | ||
Distribue un événement dans le flux d’événements. | IEventDispatcher | ||
Filtre un ensemble de valeurs de type arbitraire pour produire un ensemble de nombres qui peuvent être mappés. | IAxis | ||
Formate les valeurs pour les afficher dans des objets DataTip. | IAxis | ||
Détermine la plage de valeurs permettant d’estimer les libellés d’axe appropriés. | IAxis | ||
Obtient le texte des libellés rendus. | IAxis | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | IEventDispatcher | ||
Mappe une position le long de l’axe à une valeur de données numérique. | IAxis | ||
Convertit un ensemble de valeurs de type arbitraire en un ensemble de nombres qui peuvent être transformés en coordonnées d’écran. | IAxis | ||
Détermine la manière dont l’axe traite les libellés qui se chevauchent. | IAxis | ||
Appelée lorsqu’un objet AxisRenderer est incapable de rendre correctement les libellés sans chevauchement et qu’il souhaite que l’objet Axis réduise l’ensemble de libellés. | IAxis | ||
Chaque transformation DataTransform qui utilise un axe s’enregistre auprès de cet axe. | IAxis | ||
Supprime un écouteur de l’objet EventDispatcher. | IEventDispatcher | ||
Mappe à l’espace d’écran un ensemble de valeurs issues de l’espace de données. | IAxis | ||
Chaque transformation DataTransform qui utilise un axe s’enregistre auprès de cet axe. | IAxis | ||
Met à jour le graphique. | IAxis | ||
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é. | IEventDispatcher |
baseline | propriété |
baseline:Number
[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 |
Position de la ligne de base de l’axe. Certaines séries telles que ColumnSeries ou AreaSeries utilisent cette valeur pour définir la base d’une région remplie lorsqu’aucune valeur minimale n’est spécifiée.
Implémentation
public function get baseline():Number
chartDataProvider | propriété |
chartDataProvider:Object
[écriture seule] Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Fournisseur de données affecté au graphique conteneur. Les types d’axes basés sur un fournisseur de données peuvent choisir d’hériter ou non du fournisseur de données associé au graphique conteneur. Si un axe est commun à plusieurs graphiques, la valeur de cette propriété est undefined
(il s’agit la plupart du temps du dernier fournisseur de données affecté à l’un des graphiques associés).
Implémentation
public function set chartDataProvider(value:Object):void
displayName | propriété |
displayName:String
[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 |
Nom de l’axe. Si cette valeur est définie, Flex utilise ce nom pour formater des contrôles DataTip.
Implémentation
public function get displayName():String
title | propriété |
unitSize | propriété |
unitSize:Number
[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 |
Taille d’une unité de données représentée par cet axe. Cette valeur est utilisée par différents types de séries pour faciliter le rendu. La classe ColumnSeries, par exemple, utilise cette valeur pour déterminer la largeur de rendu des colonnes. Les différents types d’axes renvoient des valeurs différentes, qui dépendent parfois des données représentées. La classe DateTimeAxis, par exemple, peut renvoyer le nombre de millisecondes écoulées en un jour ou une année, en fonction des données rendues dans le graphique. Cette valeur dépendant de la collecte des données représentées, les séries personnalisées ne peuvent pas supposer que cette valeur est exacte dans leurs méthodes updateData()
ou updateMapping()
.
Implémentation
public function get unitSize():Number
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 |
Déclenche des événements qui signalent à l’objet de plage de valeurs que les données du graphique ont changé.
filterCache | () | méthode |
public function filterCache(cache:Array, field:String, filteredString: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 |
Filtre un ensemble de valeurs de type arbitraire pour produire un ensemble de nombres qui peuvent être mappés.
Paramètres
cache:Array — Tableau d’objets à partir duquel les valeurs converties sont lues et dans lequel elles sont stockées.
| |
field:String — Champ des objets du tableau de cache qui contient les valeurs préfiltrées.
| |
filteredString:String — Champ des objets du tableau de cache dans lequel les valeurs filtrées doivent être stockées.
|
formatForScreen | () | méthode |
public function formatForScreen(value:Object):String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Formate les valeurs pour les afficher dans des objets DataTip. Renvoie une chaîne lisible par l’utilisateur.
Paramètres
value:Object — Valeur à convertir en chaîne.
|
String — Texte de l’objet DataTip.
|
getLabelEstimate | () | méthode |
public function getLabelEstimate():AxisLabelSet
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Détermine la plage de valeurs permettant d’estimer les libellés d’axe appropriés. L’axe appelle presque immédiatement la méthode getLabels()
pour obtenir les valeurs réelles. L’axe utilise les valeurs estimées pour ajuster les marges du graphique. Par conséquent, si les libellés estimés et les libellés réels (renvoyés par la méthode getLabels()
) diffèrent, les libellés sont mis à l’échelle pour que leur taille soit adaptée au graphique.
Pour renvoyer une estimation, un axe a besoin uniquement des libellés minimal et maximal. Si l’ensemble de libellés est relativement statique et ne dépend pas de la taille des axes rendus à l’écran, un axe peut renvoyer l’intégralité de l’ensemble de libellés à partir de cette fonction et marquer l’estimation comme étant exacte.
Valeur renvoyéeAxisLabelSet — Tableau d’objets AxisLabel.
|
getLabels | () | méthode |
public function getLabels(minimumAxisLength:Number):AxisLabelSet
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Obtient le texte des libellés rendus. Lorsque Flex appelle cette méthode, l’axe a déjà déterminé la longueur minimale du libellé.
Paramètres
minimumAxisLength:Number — Longueur minimale de l’axe, en pixels. L’axe peut être plus court que cette valeur, mais pas plus long.
|
AxisLabelSet — Tableau d’objets AxisLabel.
|
invertTransform | () | méthode |
public function invertTransform(value:Number):Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Mappe une position le long de l’axe à une valeur de données numérique.
Paramètres
value:Number — Limite de l’axe. La valeur de ce paramètre doit être comprise entre 0 et 1, 0 représentant la limite minimale de l’axe et 1 sa limite maximale.
|
Object — Objet contenant la valeur transformée.
|
mapCache | () | méthode |
public function mapCache(cache:Array, field:String, convertedField:String, indexValues:Boolean = false):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Convertit un ensemble de valeurs de type arbitraire en un ensemble de nombres qui peuvent être transformés en coordonnées d’écran.
Paramètres
cache:Array — Tableau d’objets à partir duquel les valeurs converties sont lues et dans lequel elles sont stockées.
| |
field:String — Champ des objets du tableau de cache qui contient les valeurs préconverties.
| |
convertedField:String — Champ des objets du tableau de cache dans lequel les valeurs converties doivent être stockées.
| |
indexValues:Boolean (default = false ) — La valeur de ce paramètre est true si les valeurs mappées sont des valeurs d’index et false s’il s’agit de valeurs de données naturelles.
|
preferDropLabels | () | méthode |
public function preferDropLabels():Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Détermine la manière dont l’axe traite les libellés qui se chevauchent. En général, les plages de valeurs numériques renvoient true
, au contraire des plages de valeurs distinctes. Vous pouvez remplacer cette propriété en la définissant directement sur l’axe.
Boolean — true si les libellés peuvent être omis sans perte de données, false dans le cas contraire.
|
reduceLabels | () | méthode |
public function reduceLabels(intervalStart:AxisLabel, intervalEnd:AxisLabel):AxisLabelSet
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Appelée lorsqu’un objet AxisRenderer est incapable de rendre correctement les libellés sans chevauchement et qu’il souhaite que l’objet Axis réduise l’ensemble de libellés. Les deux libellés qui se chevauchent sont transmis à la méthode.
Paramètres
intervalStart:AxisLabel — Début de l’intervalle de chevauchement des libellés.
| |
intervalEnd:AxisLabel — Fin de l’intervalle de chevauchement des libellés.
|
AxisLabelSet — Nouvel ensemble de libellés résolvant le chevauchement en réduisant le nombre de libellés.
|
registerDataTransform | () | méthode |
public function registerDataTransform(transform:mx.charts.chartClasses:DataTransform, dimensionName: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 |
Chaque transformation DataTransform qui utilise un axe s’enregistre auprès de cet axe. L’axe est chargé d’informer la transformation lorsque ses valeurs pertinentes changent. Il doit également obtenir les valeurs auprès de la transformation lorsqu’il souhaite générer automatiquement des valeurs minimale et maximale.
Paramètres
transform:mx.charts.chartClasses:DataTransform — Transformation DataTransform à enregistrer.
| |
dimensionName:String — Nom de la dimension.
|
transformCache | () | méthode |
public function transformCache(cache:Array, field:String, convertedField: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 à l’espace d’écran un ensemble de valeurs issues de l’espace de données.
Paramètres
cache:Array — Tableau d’objets à partir duquel les valeurs mappées sont lues et dans lequel elles sont stockées.
| |
field:String — Champ des objets du tableau de cache qui contient les valeurs prémappées.
| |
convertedField:String — Champ des objets du tableau de cache dans lequel les valeurs mappées doivent être stockées.
|
unregisterDataTransform | () | méthode |
public function unregisterDataTransform(transform:mx.charts.chartClasses:DataTransform):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Chaque transformation DataTransform qui utilise un axe s’enregistre auprès de cet axe. L’axe est chargé d’informer la transformation lorsque ses valeurs pertinentes changent. Il doit également obtenir les valeurs auprès de la transformation lorsqu’il souhaite générer automatiquement des valeurs minimale et maximale.
Paramètres
transform:mx.charts.chartClasses:DataTransform — Transformation DataTransform à désenregistrer.
|
update | () | méthode |
public function update():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Met à jour le graphique. Cette méthode peut être appelée plusieurs fois par image.
Tue Jun 12 2018, 09:30 AM Z