Series  - AS3 Flex

Spécifie une méthode renvoyant la valeur à utiliser pour placer l’élément de graphique actuel dans la série. Lorsque cette propriété est définie, la valeur de retour de la fonction de données personnalisée est prioritaire par rapport aux autres propriétés associées, telles que xField et yField pour les objets AreaSeries, BarSeries, BubbleSeries, ColumnSeries, LineSeries et PlotSeries. Pour un objet BubbleSeries, la valeur de retour est prioritaire par rapport à la propriété radiusField. Pour un objet PieSeries, la valeur de retour est prioritaire par rapport à la propriété field.

La fonction dataFunction personnalisée d’une série présente la signature suivante :

     function_name (series:Series, item:Object, fieldName:String):Object { ... }
     

La propriété dataFunction est en général utilisée pour accéder aux champs d’un fournisseur de données qui ne constituent pas des valeurs scalaires et qui sont imbriqués dans le fournisseur de données. Par exemple, les données ci-dessous nécessitent une fonction de données pour accéder aux champs du fournisseur de données d’un graphique :

      {month: "Aug", close: {High:45.87,Low:12.2}, open:25.19}
      

L’exemple suivant renvoie une valeur de ce fournisseur de données :

     public function myDataFunction(series:Series, item:Object, fieldName:String):Object {
          if (fieldName == 'yValue')
              return(item.close.High);
          else if (fieldName == "xValue")
              return(item.month);
          else
              return null;
     }     
     

Tableau d’éléments de graphique pour lesquels des objets DataTip doivent être affichés de manière non interactive dans le graphique.

Objet DataTransform auquel l’élément est associé. Un objet DataTransform représente une association entre un ensemble d’éléments et un ensemble d’objets d’axe, utilisée pour convertir ces éléments d’espace de données en coordonnées d’écran et vice-versa. Un élément de graphique utilise l’objet DataTransform qui lui est associé pour calculer comment rendre ses données.

Nom de la série à présenter à l’utilisateur. Cette propriété est utilisée pour représenter la série dans les libellés visibles par l’utilisateur, tels que les objets DataTip.

Si la propriété filterFunction ou filterDataValues est définie, la propriété filterData est ignorée. true si la série filtre les données avant de les afficher. Si une série rend des données contenant des valeurs manquantes (null, undefined ou NaN, par exemple) ou des valeurs qui se trouvent en dehors de la plage de valeurs des axes du graphique, cette propriété doit être définie sur true (valeur par défaut). Si vous savez que toutes les données de la série sont valides, vous pouvez la définir sur false pour améliorer les performances.

Si la propriété filterFunction est définie, les propriétés filterDataValues et filterData sont ignorées. Si la propriété filterDataValues est définie sur aucun, la série ne filtre pas ses données avant de les afficher. Si la propriété filterDataValue est définie sur null, la série filtre les données telles que null, indéfini, ou NaN avant de les afficher. Si cette propriété est définie sur OutsideRange, la série filtre ses données telles que null, indéfini, ou NaN, ainsi que les valeurs situées hors de la plage des axes du graphique. Si vous savez que toutes les données de la série sont valides, vous pouvez la définir suraucun pour améliorer la performance.

Spécifie une méthode qui renvoie le tableau d’éléments graphiques dans les séries à afficher. Si cette propriété est définie, la valeur de renvoie de la fonction de filtre personnalisée a la priorité sur les propriétés filterDataValues et filterData. Cependant, si la valeur renvoyée est null, les propriétés filterdataValues et filterData sont préférées dans cet ordre.

La fonction filterFunction contient les signatures suivantes :

     function_name (cache:Array):Array { ... }
     

     public function myFilterFunction(cache:Array):Array {
          var filteredCache:Array=[];
          var n:int = cache.length;  
          for(var i:int = 0; i < n; i++)
          {
              var item:ColumnSeriesItem = ColumnSeriesItem(cache[i]);
              if(item.yNumber > 0 && item.yNumber < 700)
              {
                  filteredCache.push(item);
              }
          }
          return filteredCache;
     }
     

Si vous spécifiez une fonction de filtre personnalisée pour la série de votre graphique et que vous souhaitez filtrer les valeurs null ou les valeurs en dehors de la plage des axes, vous devez les filtrer manuellement, en utilisant la fonction de filtre personnalisé. Les propriétés filterDatavalues ou filterData ne peuvent pas être utilisées.

Détermine si des objets DataTip doivent s’afficher lorsque les utilisateurs agissent sur les données de graphique affichées à l’écran. Définissez cette propriété sur false pour empêcher la série d’afficher des objets DataTip ou de générer des données liées aux interactions de l’utilisateur.

La valeur par défaut est true.

Obtient tous les éléments présents dans la série après filtrage.

Les différentes séries déterminent la liste des éléments à renvoyer.

Tableau d’instances LegendData décrivant les éléments qui doivent s’afficher dans une légende représentant cette série. Les classes de série dérivées remplacent cet accesseur de lecture et renvoient des données de légende propres à leurs styles et à leur méthode de représentation des données. Bien que la plupart des types de séries renvoient une seule instance LegendData, certains d’entre eux (par exemple PieSeries et StackedSeries) renvoient plusieurs instances représentant différents éléments du tableau ou différentes manières de rendre les données.

Stocke les informations nécessaires au rendu de cette série.

Détermine si une série peut ou non être sélectionnée.

La valeur par défaut est true.

Index de l’élément sélectionné dans le fournisseur de données de la série. Si plusieurs éléments sont sélectionnés, cette propriété désigne l’élément sélectionné en dernier.

Tableau contenant les index des éléments sélectionnés dans le fournisseur de données de la série.

Elément de graphique sélectionné dans la série. Si plusieurs éléments sont sélectionnés, cette propriété désigne l’élément sélectionné en dernier.

Tableau des éléments de graphique sélectionnés dans la série.

Structure de données de rendu transmise par une transition en cours. Lorsqu’un effet de série est conçu pour être appliqué sur une série, il commence par capturer l’état actuel de la série en demandant ses données de rendu. La transition modifie les données de rendu pour créer l’effet souhaité et renvoie la structure à la série en vue de l’affichage. Si la valeur de la propriété transitionRenderData n’est pas null, la série utilise son contenu pour mettre à jour l’affichage.

Constructeur.

Appelée par l’effet SeriesInterpolate pour initier un effet d’interpolation. L’effet transmet les données source et les données de destination pour que la série puisse réaliser une interpolation entre ces données. L’effet transmet la valeur de retour de cette méthode de façon répétée à la méthode interpolate() de la série pour réaliser l’animation pendant toute la durée de l’effet. La série calcule les données nécessaires pour réaliser l’interpolation et les renvoie dans cette méthode.

Paramètres

Met en cache les valeurs stockées dans la propriété measureName issue des éléments dataProvider d’origine dans la propriété fieldName de l’élément de graphique. Si la valeur de la propriété measureName est null ou une chaîne vide, cette méthode suppose que les éléments du fournisseur de données d’origine sont des valeurs brutes et les met en cache.

Paramètres

Met en cache les valeurs stockées dans la propriété measureName issue des éléments dataProvider d’origine dans la propriété fieldName de l’élément de graphique. Si la valeur de la propriété measureName est null ou une chaîne vide, cette méthode stocke l’index des éléments dans la propriété fieldName.

Paramètres

Met en cache les valeurs stockées dans la propriété measureName issue des éléments dataProvider d’origine dans la propriété fieldName de l’élément de graphique.

Paramètres

Appelée par le graphique pour autoriser les éléments associés à récupérer les sélecteurs de style de son tableau chartSeriesStyles. Chaque graphique dispose de son propre ensemble de sélecteurs, qui sont implicitement affectés aux éléments contenus qui les demandent. L’implémentation de cette fonction offre à un élément la possibilité de récupérer des éléments de cet ensemble, si nécessaire. Un élément qui nécessite N sélecteurs de style récupère les valeurs comprises entre styles[firstAvailable] et styles[firstAvailable + N - 1].

Paramètres

Traite les propriétés définies sur le composant. Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de la classe UIComponent.

Vous n’appelez pas cette méthode directement. Flex appelle la méthode commitProperties() lorsque vous utilisez la méthode addChild() pour ajouter un composant à un conteneur ou lorsque vous appelez la méthode invalidateProperties() du composant. Les appels de la méthode commitProperties() sont réalisés avant les appels de la méthode measure(). Ainsi, vous pouvez définir des valeurs de propriété susceptibles d’être utilisées par la méthode measure().

Certains composants présentent des propriétés influant sur le nombre ou le type d’objets enfant à créer, ou des propriétés liées les unes aux autres, telles que horizontalScrollPolicy et horizontalScrollPosition. En règle générale, il est préférable de traiter toutes ces propriétés en même temps au démarrage pour éviter d’avoir à réaliser plusieurs fois les mêmes opérations.

Cette opération est nécessaire si vous ne réglez pas de fonction personnalisée en tant que fonction filterFunction de la série. Chaque série individuelle doit la remplacer.

Paramètres

Gestionnaire par défaut pour l’événement dragStart.

Paramètres

Appelée par l’effet SeriesInterpolate pour mettre fin à un effet d’interpolation. L’effet utilise cette méthode pour terminer l’interpolation et nettoyer l’éventuel état temporaire associé à l’effet.

Paramètres

Extrait la valeur minimale, la valeur maximale et éventuellement l’intervalle minimal à partir d’un tableau d’objets ChartItem. Les classes dérivées peuvent appeler cette méthode à partie de leurs implémentations de la méthode describeData() pour remplir les détails de la structure DataDescription.

Paramètres

Extrait la valeur minimale, la valeur maximale et éventuellement l’intervalle minimal à partir d’un tableau d’objets ChartItem. Les classes dérivées peuvent appeler cette méthode à partie de leurs implémentations de la méthode describeData() pour remplir les détails de la structure DataDescription.

Paramètres

En général, vous extrayez l’instance Axis directement par le biais d’une propriété nommée, telle que horizontalAxis, verticalAxis ou radiusAxis dans le cas d’une série de type Cartesian.

Il s’agit d’un accesseur de bas niveau.

Paramètres

Remplit les propriétés elementBounds, bounds et visibleBounds d’une structure renderData générée par la série. Les classes d’effet appellent cette méthode pour remplir ces champs utilisés pour l’implémentation de différents types d’effets. Les classes dérivées doivent implémenter cette méthode pour générer les limites des éléments de la série uniquement lorsque cela est nécessaire.

Paramètres

Obtient tous les éléments de la série qui se trouvent dans une région rectangulaire. Appelez cette fonction pour déterminer quels éléments de la série se trouvent dans une région rectangulaire particulière.

Les différentes séries déterminent si leur élément de graphique se trouve ou non dans la région. Le point doit se trouver dans l’espace de coordonnées global.

Paramètres

Eléments de l’API associés

Remplit les valeurs manquantes dans une structure d’interpolation. Lorsqu’une série appelle la méthode initializeInterpolationData(), elle transmet des tableaux de valeurs source et de valeurs de destination pour l’interpolation. Si l’un ou l’autre de ces tableaux est incomplet, la série doit fournir des valeurs d’espace réservé adaptées pour l’interpolation. La manière dont ces valeurs d’espace réservé sont déterminées dépend du type de série. Les extendeurs de série doivent remplacer cette méthode pour fournir ces valeurs d’espace réservé.

Paramètres