CategoryAxis  - AS3 Flex

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.

Spécifie le champ du fournisseur de données qui contient le texte des libellés. Si la valeur de cette propriété est null, l’objet CategoryAxis suppose que le fournisseur de données contient un tableau de chaînes.

La valeur par défaut est null.

Spécifie une méthode qui renvoie la valeur à utiliser comme valeur categoryValue pour l’élément actuel. Si cette propriété est définie, la valeur de retour de la fonction de données personnalisée est prioritaire par rapport à la propriété categoryField

La fonction dataFunction personnalisée présente la signature suivante :

     function_name (axis:CategoryAxis, item:Object):Object { ... }
     

Une fonction dataFunction personnalisée permet par exemple de renvoyer une valeur à partir d’un fournisseur dataProvider contenant des éléments à champs imbriqués

     public function myFunction(axis:CategoryAxis,item:Object):Object {
          return(item.Country.State);
     }     
     

Spécifie la source de données contenant les noms des libellés. Le fournisseur dataProvider peut être un tableau de valeurs, un tableau d’objets ou tout objet implémentant l’interface IList ou ICollectionView. Si le fournisseur dataProvider est un tableau de chaînes, veillez à ce que la propriété categoryField soit définie sur null. Si le fournisseur dataProvider est un tableau d’objets, définissez la propriété categoryField sur le nom du champ contenant le texte du libellé.

Spécifie une fonction qui définit les libellés générés pour chaque élément dans le fournisseur dataProvider de l’objet CategoryAxis. Si aucune fonction labelFunction n’est fournie, les libellés d’axe prennent par défaut la valeur de la catégorie elle-même.

La méthode labelFunction d’un objet CategoryAxis présente la signature suivante :

      function function_name(categoryValue:Object, previousCategoryValue:Object, axis:CategoryAxis, categoryItem:Object):String { ... }
      

Où :

• categoryValue correspond à la valeur de la catégorie à représenter.
• previousCategoryValue correspond à la valeur de la catégorie précédente sur l’axe.
• axis correspond à l’objet CategoryAxis à rendre.
• categoryItem correspond à l’élément du fournisseur dataProvider qui est représenté.

Flex affiche la chaîne renvoyée en tant que libellé de l’axe.

Si la propriété categoryField n’est pas définie, la valeur est identique à celle de la propriété categoryValue.

Spécifie la marge tée de part et d’autre de l’axe lors du rendu de l’élément à l’écran. Définissez cette valeur sur 0 pour placer la première catégorie au tout début de l’axe et la dernière catégorie à la fin. Définissez cette valeur sur 0.5 pour conserver une marge correspondant à la moitié de la largeur d’une catégorie sur l’axe entre le début de l’axe et la première catégorie et entre la dernière catégorie et la fin de l’axe.

Cette propriété est utile pour les types de graphiques dont le rendu s’étend au-delà des limites de la catégorie (colonnes et barres, par exemple). Cependant, lorsque vous l’utilisez comme valeur horizontalAxis dans un contrôle LineChart ou AreaChart, elle est réinitialisée sur 0.

La valeur par défaut est 0.5.

Spécifie la position des graduations principales le long de l’axe, par rapport aux libellés des catégories. Si la valeur est true, les graduations ainsi que la grille associée apparaissent entre les catégories. Si la valeur est false, les graduations apparaissent au milieu de la catégorie, dans le prolongement du libellé.

Constructeur.

Filtre un ensemble de valeurs de type arbitraire pour produire un ensemble de nombres qui peuvent être mappés.

Paramètres

Formate les valeurs pour les afficher dans des objets DataTip. Renvoie une chaîne lisible par l’utilisateur.

Paramètres

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.

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

Mappe une position le long de l’axe à une valeur de données numérique.

Paramètres

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

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.

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

Mappe à l’espace d’écran un ensemble de valeurs issues de l’espace de données.

Paramètres

Met à jour le graphique. Cette méthode peut être appelée plusieurs fois par image.