ColumnSeries  - AS3 Flex

Spécifie la largeur des colonnes 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 colonne. En règle générale, vous ne devez pas définir cette propriété directement. La largeur réelle de la colonne correspond soit à la valeur de la propriété columnWidthRatio, soit à la valeur de maxColumnWidth, la plus petite des deux étant prise en compte.

La valeur par défaut est 0.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:ColumnSeriesItem = ColumnSeriesItem(item);
          if (curItem.yNumber > 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:ColumnSeriesItem = ColumnSeriesItem(element);
          var ser:ColumnSeries = ColumnSeries(series);
          return(item.item.Country + ":" +"" + ser.yField.toString() +":"+ item.yNumber);
     }
     

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

Spécifie le champ du fournisseur de données qui détermine la position du bas d’une colonne sur l’axe Y. 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 colonnes doit être décalé par rapport au centre de l’espace disponible, selon la largeur des catégories. Si la valeur est 0, les colonnes sont centrées dans l’espace disponible. 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 devez pas définir cette propriété directement. Le contrôle ColumnChart gère cette valeur en fonction de sa propriété columnWidthRatio.

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.

Demande de trier les colonnes de gauche à droite avant le rendu. Par défaut, la classe ColumnSeries rend les colonnes dans l’ordre dans lequel elles apparaissent dans le fournisseur de données.

Si vous utilisez la propriété xField pour déterminer la position de chaque colonne, celles-ci peuvent apparaître dans un autre ordre à l’écran. Les colonnes peuvent être rendues dans n’importe quel ordre. Cependant, certaines colonnes personnalisées peuvent nécessiter que les colonnes soient rendues de gauche à droite.

La valeur par défaut est false.

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 de la colonne sur l’axe X. Si la valeur est null, Flex rend les colonnes dans l’ordre dans lequel elles 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 du haut d’une colonne sur l’axe Y. Si la valeur est null, la classe ColumnSeries 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.

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.