BubbleSeries  - AS3 Flex

Spécifie une méthode renvoyant le remplissage de l’élément de graphique actuel de la série. Lorsque cette propriété est définie, la valeur de retour de la fonction de remplissage personnalisée est prioritaire par rapport aux propriétés de style fill et fills. Cependant, si la valeur renvoyée est null, les propriétés fills et fill sont prises en compte, dans cet ordre.

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

     function_name (item:ChartItem, index:Number):IFill { ... }
     

L’utilisation d’une fonction fillFunction personnalisée permet par exemple de renvoyer un remplissage en fonction d’un certain seuil.

     public function myFillFunction(item:ChartItem, index:Number):IFill {
          var curItem:BubbleSeriesItem = BubbleSeriesItem(item);
          if (curItem.zNumber > 10)
              return(new SolidColor(0x123456, .75));
          else
              return(new SolidColor(0x563412, .75));
     }
     

Si vous spécifiez une fonction de remplissage personnalisée pour la série du graphique et que vous souhaitez disposer d’un contrôle Legend, vous devez créer manuellement le contrôle Legend et y ajouter des objets LegendItem.

Définit les libellés, les graduations et la position des données des éléments de l’axe X. Utilisez la classe LinearAxis ou CategoryAxis pour définir les propriétés de l’objet horizontalAxis en tant que balise enfant en langage MXML, ou pour créer un objet LinearAxis ou CategoryAxis en langage ActionScript.

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.

Sous-type d’objet ChartItem utilisé par cette série pour représenter les différents éléments. Les sous-classes peuvent effectuer un remplacement et renvoyer une classe plus spécialisée si elles doivent stocker des informations supplémentaires dans les éléments.

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.

Rayon du plus grand élément rendu dans cette série. Lorsque vous utilisez un objet BubbleSeries dans une classe BubbleChart, le graphique affecte automatiquement sa valeur de style maxRadius à cette propriété, pour toutes les séries du graphique. Lorsque vous utilisez des objets BubbleSeries dans des contrôles CartesianChart, vous devez gérer cette propriété manuellement.

Rayon du plus petit élément rendu dans cette série. Lorsque vous utilisez un objet BubbleSeries dans une classe BubbleChart, le graphique affecte automatiquement sa valeur de style minRadius à cette propriété, pour toutes les séries du graphique. Lorsque vous utilisez des objets BubbleSeries dans des contrôles CartesianChart, vous devez gérer cette propriété manuellement.

Une fabrique de modules est utilisée comme contexte d’utilisation de polices intégrées et pour la recherche du gestionnaire de style qui contrôle les styles de ce composant.

Axe auquel est mappé le rayon de la bulle. Les graphiques à bulles considèrent la taille des différentes bulles comme une troisième dimension des données, qui est transformée de la même manière que les positions x et y. Par défaut, radiusAxis est un objet LinearAxis dont la propriété autoAdjust est définie sur false.

Spécifie le champ du fournisseur de données qui détermine le rayon de chaque symbole, par rapport aux autres points de données du graphique.

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

Sous-type de données ChartRenderData utilisé par cette série pour stocker toutes les données nécessaires au rendu. Les sous-classes peuvent effectuer un remplacement et renvoyer une classe plus spécialisée si elles doivent stocker des informations supplémentaires pour le rendu.

Définit les libellés, les graduations et la position des données des éléments de l’axe Y. Utilisez la classe LinearAxis ou CategoryAxis pour définir les propriétés de l’objet verticalAxis en tant que balise enfant en langage MXML, ou pour créer un objet LinearAxis ou CategoryAxis en langage ActionScript.

Spécifie le champ du fournisseur de données qui détermine la position de chaque point de données sur l’axe X. Si la valeur est null, Flex rend les points de données dans l’ordre dans lequel ils apparaissent dans le fournisseur de données.

La valeur par défaut est null.

Spécifie le champ du fournisseur de données qui détermine la position de chaque point de données sur l’axe Y. Si la valeur est null, la classe BubbleSeries suppose que le fournisseur de données est un tableau de nombres et utilise ces nombres comme valeurs pour les points de données.

La valeur par défaut est null.

Constructeur.

Applique des propriétés de style à l’objet DisplayObject spécifié. Cette méthode est le rappel appelé par la classe InstanceCache lorsqu’elle crée une nouvelle fonctionnalité de rendu.

Paramètres

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

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.

Appelée par la classe DataTransform gouvernante pour obtenir une description des données représentées par cet élément IChartElement. Les implémenteurs remplissent et renvoient un tableau d’objets mx.charts.chartClasses.DataDescription pour garantir que leurs données sont correctement prises en compte par les axes générant automatiquement les valeurs à partir des données affichées (par exemple minimum, maximum, interval et unitSize). La plupart des types d’éléments renvoient un tableau contenant une seule description DataDescription. Les agrégats tels que BarSet et ColumnSet peuvent renvoyer plusieurs instances DataDescription décrivant les données affichées par leurs sous-éléments. Lorsque cette méthode est appelée, l’implémenteur décrit les données le long de l’axe indiqué par l’argument dimension. Cette fonction peut être appelée pour chaque axe pris en charge par le graphique conteneur.

Paramètres

Trouve le point de données le plus proche représenté par l’élément qui se trouve sous les coordonnées spécifiées.

Cette méthode renvoie un tableau de structures HitData décrivant les points de données de la plage. Certains éléments ChartElement individuels peuvent choisir de renvoyer un seul point dataPoint s’il est garanti que ces points dataPoint ne se chevauchent pas.

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

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

Détecte les modifications apportées aux propriétés de style. Lorsqu’une propriété de style est définie, Flex appelle la méthode styleChanged() et lui transmet le nom du style défini.

Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de la classe UIComponent. Lorsque vous créez un composant personnalisé, vous pouvez remplacer la méthode styleChanged() pour vérifier le nom de style qui lui a été transmis et traiter la modification en conséquence. Vous pouvez ainsi remplacer le comportement par défaut d’un style existant ou ajouter vos propres propriétés de style personnalisé.

Si vous traitez la propriété de style, le remplacement de la méthode styleChanged() doit appeler la méthode invalidateDisplayList() pour que Flex exécute la méthode updateDisplayList() du composant lors de la prochaine mise à jour de l’affichage.

Paramètres

Appelée lorsque les données sous-jacentes représentées par la série ont été modifiées et doivent être rechargées à partir du fournisseur de données. Si vous implémentez des types de série personnalisés, vous devez remplacer cette méthode et charger toutes les données nécessaires au rendu de la série à partir du fournisseur de données. Vous devez également appeler la méthode super.updateData() dans la sous-classe. En règle générale, vous ne devez pas appeler cette méthode directement. En revanche, pour garantir que les données ont été mises à jour à tel ou tel endroit, appelez la méthode validateData() de la classe Series.

Trace l’objet et/ou dimensionne et place ses enfants. 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 updateDisplayList() lorsque le composant est ajouté à un conteneur par le biais de la méthode addChild() et lorsque la méthode invalidateDisplayList() du composant est appelée.

Si le composant n’a pas d’enfant, cette méthode permet de réaliser un tracé par programmation en utilisant les méthodes sur l’objet Graphics du composant, par exemple graphics.drawRect().

Si le composant a au moins un enfant, cette méthode permet d’appeler les méthodes move() et setActualSize() sur ces enfants.

Les composants peuvent réaliser un tracé par programmation, même s’ils ont des enfants. Pour ce faire, utilisez les propriétés unscaledWidth et unscaledHeight du composant comme ses limites.

Il est indispensable d’utiliser unscaledWidth et unscaledHeight à la place des propriétés width et height.

Paramètres

Appelée lorsque les données sous-jacentes représentées par la série doivent être filtrées par rapport aux plages de valeurs représentées par les axes de la transformation de données associée. Cette situation peut se produire lorsque les données sous-jacentes ont été modifiées ou lorsque la plage de valeurs des axes associés a changé. Si vous implémentez un type de série personnalisé, vous devez remplacer cette méthode et filtrer les données hors plage en utilisant la méthode filterCache() des axes gérés par la transformation de données associée. La méthode filterCache() convertit les valeurs hors plage en valeurs NaN. Vous devez également appeler la méthode super.updateFilter() dans la sous-classe. En règle générale, vous ne devez pas appeler cette méthode directement. En revanche, si vous souhaitez garantir que les données ont été filtrées à tel ou tel endroit, appelez la méthode validateTransform() de la classe Series. En général, vous pouvez supposer que les méthodes updateData() et updateMapping() ont été appelées avant cette méthode, si nécessaire.

Appelée lorsque les données sous-jacentes représentées par la série doivent être mappées à des représentations numériques. Cette situation peut se produire lorsque les données sous-jacentes ont été modifiées ou lorsque les axes utilisés pour le rendu de la série ont fait l’objet de modifications significatives. Si vous implémentez une série personnalisée, vous devez remplacer cette méthode et convertir les données représentées en valeurs numériques, en utilisant la méthode mapCache() des axes gérés par la transformation de données associée. Vous devez également appeler la méthode super.updateMapping() dans la sous-classe. En règle générale, vous ne devez pas appeler cette méthode directement. En revanche, pour garantir que les données ont été mappées à tel ou tel endroit, appelez la méthode validateData() de la classe Series. En général, vous pouvez supposer que la méthode updateData() a été appelée avant cette méthode, si nécessaire.

Appelée lorsque les données sous-jacentes représentées par la série doivent être transformées en valeurs d’écran par les axes de la transformation de données associée. Cette situation peut se produire lorsque les données sous-jacentes ont été modifiées, lorsque la plage de valeurs des axes associés a changé, ou encore lorsque la taille de la zone à l’écran a changé. Si vous implémentez un type de série personnalisé, vous devez remplacer cette méthode et transformer les données en utilisant la méthode transformCache() de la transformation de données associée. Vous devez également appeler la méthode super.updateTransform() dans la sous-classe. En règle générale, vous ne devez pas appeler cette méthode directement. En revanche, si vous souhaitez garantir que les données ont été filtrées à tel ou tel endroit, appelez la méthode validateTransform() de la classe Series. En général, vous pouvez supposer que les méthodes updateData(), updateMapping() et updateFilter() ont été appelées avant cette méthode, si nécessaire.

Type d’axe de rayon.