BarSeries  - AS3 Flex

Spécifie la largeur de rendu des barres par rapport à la largeur des catégories. La valeur 1 utilise l’intégralité de l’espace et la valeur .6 60 % de l’espace disponible pour la barre. En règle générale, vous ne devez pas définir cette propriété directement. La largeur réelle de la barre correspond soit à la valeur de la propriété barWidthRatio, soit à la valeur de maxbarWidth, la plus petite des deux étant prise en compte.

La valeur par défaut est .65.

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:BarSeriesItem = BarSeriesItem(item);
          if (curItem.xNumber > 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.

Nom d’un champ du fournisseur de données dont la valeur apparaît en tant que libellé. Cette propriété est ignorée si la propriété labelFunction est définie.

Spécifie une fonction de rappel utilisée pour rendre chaque libellé de la série. Une fonction labelFunction doit présenter la signature suivante :

     function function_name(element:ChartItem, series:Series):String { ... }
     

Voici un exemple d’utilisation d’une fonction labelFunction personnalisée :

     private function myLabelFunction(element:ChartItem, series:Series):String {
          var item:BarSeriesItem = BarSeriesItem(element);
          var ser:BarSeries = BarSeries(series);
          return(item.item.Country + ":" +"" + ser.xField.toString() +":"+ item.xNumber);
     }
     

Spécifie la largeur des barres, en pixels. La largeur réelle de la barre correspond soit à la valeur du style, soit à la valeur de la propriété barWidthRatio, la plus petite des deux étant prise en compte. Les barres regroupées divisent cet espace proportionnellement entre les barres de chaque groupe.

Spécifie le champ du fournisseur de données qui détermine la position du bas de chaque barre. Si la valeur est null, le bas des colonnes est placé au niveau de la valeur minimale de la plage (ou de la valeur maximale, si la valeur du champ est négative).

La valeur par défaut est null.

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.

Spécifie dans quelle mesure le centre des barres doit être décalé par rapport au centre de l’espace disponible, selon la largeur des catégories. La plage des valeurs est un pourcentage de la plage qui s’étend de -100 à 100. Définissez cette propriété sur 0 pour centrer les barres dans l’espace. Définissez cette propriété sur -50 pour centrer la colonne au début de l’espace disponible. En règle générale, vous ne définissez pas cette propriété directement.

La valeur par défaut est 0.

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.

Classe StackedSeries associée à cette classe BarSeries. La propriété stacker gère le comportement d’empilement de la série.

Totaux de pile pour la série.

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 du haut de chaque barre colonne sur l’axe X. Si la valeur est null, la classe BarSeries suppose que le fournisseur de données est un tableau de nombres et utilise ces nombres comme valeurs.

La valeur par défaut est null.

Spécifie le champ du fournisseur de données qui détermine la position du bas de chaque barre sur l’axe Y du graphique. Si la valeur est null, Flex place les barres dans l’ordre des données dans le fournisseur de données.

La valeur par défaut est null.

Constructeur.

Personnalise les instances de fonctionnalité de rendu d’élément utilisées pour représenter le graphique. Cette méthode est appelée automatiquement chaque fois qu’une nouvelle fonctionnalité de rendu est nécessaire pendant le processus de rendu du graphique. Si vous le souhaitez, vous pouvez remplacer cette méthode pour personnaliser les paramètres.

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.

Crée les objets enfant du 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.

Un composant qui crée d’autres composants ou des objets à l’intérieur de ce composant s’appelle un composant composite. Par exemple, le contrôle ComboBox de Flex est réellement composé d’un contrôle TextInput qui permet de définir la zone de texte du contrôle ComboBox et d’un contrôle Button qui définit la flèche du contrôle ComboBox. Les composants implémentent la méthode createChildren() pour créer des objets enfant (d’autres composants, par exemple) dans le composant.

Vous appelez la méthode addChild() au sein d’un remplacement de la méthode createChildren() pour ajouter chaque objet enfant.

Vous n’appelez pas cette méthode directement. Flex appelle la méthode createChildren() en réponse à l’appel de la méthode addChild() pour ajouter le composant à son parent.

Signale à la série que les données sous-jacentes du fournisseur de données ont changé. Cette fonction déclenche l’appel des méthodes updateData(), updateMapping(), updateFilter() et updateTransform() lors du prochain appel de la méthode commitProperties(). Si des effets de données sont affectés à des éléments du graphique, cette méthode déclenche également les effets d’affichage et de masquage.

Paramètres