Les classes implémentent cette interface pour fournir des fonctionnalités de définition de plage de valeurs.
function creationCallback(newInstance:Object, cache:InstanceCache):void;
Cette propriété est pertinente uniquement lorsque la fabrique génère des objets DisplayObject. Le fait de définir cette propriété sur
Cette propriété est pertinente uniquement lorsque la fabrique génère des objets DisplayObject. Le fait de définir cette propriété sur
Les valeurs de la table de hachage ne sont pas clonées. Les valeurs d’objet sont communes à toutes les occurrences.
Lorsque vous utilisez des graphiques dans vos applications, il n’est en général pas nécessaire d’agir sur l’objet CartesianTransform. Les transformations sont créées automatiquement par les types de graphiques intégrés et utilisées par les séries que ces graphiques contiennent, de sorte qu’elles puissent transformer les données en coordonnées de rendu.
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.
Les différentes séries déterminent la liste des éléments à renvoyer.
<mx:tagname Properties allElements="Array; No default" annotationElements="Array; No default" backgroundElements="Array; No default" chartState="" clipContent="false|true" dataProvider="No default" dataRegion"No default" dataTipFunction="No default" dataTipLayerIndex"No default" dataTipMode"No default" description"No default" dragEnabled="false|true" dragMoveEnabled="false|true" dropEnabled="false|true" labelElements"No default" legendData"No default" mouseSensitivity="5" selectedChartItem=ChartItem; No default" selectedChartItems=Array; No default" selectionMode="none|single|multiple" series="No default" seriesFilters"No default" showAllDataTips="true|false" showDataTips="true|false" transforms="No default" Styles chartSeriesStyles="Style; No default" dataTipCalloutStroke="Stroke; No default" dataTipRenderer="Renderer; No default" fill="IFill; No default" fontFamily="Verdana" fontSize="10" itemDisabledColor="uint; No default" itemRollOverColor="uint; No default" itemSelectionColor="uint; No default" maximumDataTipCount="NaN" paddingBottom="No default" paddingTop="No default" paddingLeft="0" paddingRight="0" showDataTipTargets="true|false" Events change="Event; No default" itemClick="Event; No default" itemDoubleClick="Event; No default" itemMouseDown="Event; No default" itemMouseMove="Event; No default" itemMouseUp="Event; No default" itemRollOut="Event; No default" itemRollOver="Event; No default" >]]>
En règle générale, vous n’utilisez pas la classe ChartBase directement. En revanche, vous utilisez l’une de ses sous-classes, par exemple PlotChart ou BubbleChart. Elle joue le rôle de classe de base pour les types de graphiques courants fournis dans le package mx.charts.
Cette classe définit un certain nombre de styles et de propriétés CSS qui permettent d’accéder facilement aux fonctionnalités courantes de la structure.
La taille minimale d’un graphique est de 20 x 20 pixels. La taille maximale d’un graphique n’a pas de limite. La taille recommandée d’un graphique est de 400 x 400 pixels.
Les objets ChartBase et les sous-classes viennent compléter les objets d’événement de souris standard par des données supplémentaires décrivant le point de données du graphique le plus proche du pointeur de la souris. L’objet d’événement des événements de souris contient une propriété supplémentaire,
Les objets ChartBase prennent uniquement en compte les points de données qui se trouvent dans un certain rayon par rapport au pointeur de la souris. Vous pouvez définir ce rayon par le biais de la propriété
Par défaut, cette méthode appelle la méthode
Lors de la recherche des points de données les plus proches, cette méthode respecte les limites spécifiées par la propriété
Les différents types de graphiques 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.
function dataTipFunction(hitData:HitData):String
Cette méthode renvoie une chaîne affichée pour chaque point de données. Le texte peut comporter un formatage HTML. Le seul paramètre est un objet HitData décrivant le point de données.
Cette propriété peut accepter un tableau ou tout objet implémentant l’interface IList ou ICollectionView.
Valeurs possibles de la propriété
Vous pouvez personnaliser les contrôles DataTip par le biais de la propriété
La valeur par défaut de cette chaîne est une chaîne vide. La valeur doit être affectée explicitement par le développeur et avoir une signification.
Si vous définissez cette propriété sur
Lorsque la valeur de
Si vous définissez cette propriété sur
Différents éléments de graphique peuvent afficher différents styles de contrôles DataTip. Par exemple, un élément de graphique empilé peut afficher à la fois les valeurs de la colonne et le pourcentage de ces valeurs par rapport au total.
Vous pouvez personnaliser les contrôles DataTip par le biais de la propriété
Différents éléments de graphique peuvent afficher différents styles de contrôles DataTip. Par exemple, un élément de graphique empilé peut afficher à la fois les valeurs de la colonne et le pourcentage de ces valeurs par rapport au total.
Vous pouvez personnaliser les contrôles DataTip par le biais de la propriété
Pour les éléments de graphique Cartesian, deux valeurs sont en général transmises. La première valeur correspond à l’axe horizontal et la deuxième à l’axe vertical.
Dans le cas de graphiques polaires, la première valeur correspond à l’axe angulaire et la deuxième à l’axe radial.
Les différents types de graphiques déterminent la manière dont cette transformation est réalisée. Le point doit être relatif à l’espace de coordonnées du graphique.
Il n’est en général pas nécessaire d’agir sur l’objet PolarTransform. Les transformations sont créées automatiquement par les types de graphiques intégrés et utilisées par les séries que ces graphiques contiennent, de sorte qu’elles puissent transformer les données en coordonnées de rendu.
Pour activer des contrôles DataTip sur un graphique, définissez sa propriété
Cette méthode est également chargée de signaler au graphique que la série a changé et que par conséquent, les styles implicites de la série doivent être réaffectés. Cette méthode est appelée automatiquement par l’ensemble d’empilement lorsque cela est nécessaire. Au lieu d’appeler cette méthode directement, envisagez plutôt d’appeler la méthode
La région de tracé du dessin est définie par les propriétés
Si vous ajoutez un objet enfant qui est déjà doté d’un autre conteneur d’objet d’affichage en tant que parent, il est supprimé de la liste d’enfants de cet autre conteneur d’objet d’affichage.
Les paramètres et la syntaxe de cette méthode sont identiques à ceux de la méthode
Les paramètres et la syntaxe de cette méthode sont identiques à ceux de la méthode
Les paramètres et la syntaxe de cette méthode sont identiques à ceux de la méthode
Par exemple :
var lbl:Label = new Label(); lbl.text = "Last Month"; canvas.addChild(lbl); canvas.updateDataChild(lbl,200,20);
Si vous implémentez un type de dessin personnalisé, vous devez remplacer cette méthode et filtrer les données hors plage en utilisant la méthode
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
En général, vous pouvez supposer que les méthodes
Les opérations de chargement et de mappage des données sur les axes sont conçues pour être acceptées par les axes à tout moment. Vous pouvez appeler cette méthode explicitement en toute sécurité, à tout moment.
<mx:tagname displayName="No default" title="No default" >]]>
Si vous créez une sous-classe pour cette classe, vous devez remplacer cette méthode.
function function_name(labelValue:Object, previousValue:Object, axis:IAxis):String { ... }
Si vous connaissez les types de données que votre fonction formatera, vous pouvez spécifier un type explicite pour les paramètres
Une série d’empilement personnalisée implémente la méthode
<mx:CartesianDataCanvas>
tag inherits all the
properties of its parent classes and adds the following properties:
<mx:CartesianDataCanvas Properties dataChildren="No default" horizontalAxis="No default" includeInRanges="false" verticalAxis="No default" />]]>
La région de tracé du dessin est déterminée par les propriétés
Les coordonnées de données transmises en tant que paramètres aux API de tracé peuvent être les valeurs réelles de la coordonnée de données ou un objet de type
Si vous ajoutez un objet enfant qui est déjà doté d’un autre conteneur d’objet d’affichage en tant que parent, il est supprimé de la liste d’enfants de cet autre conteneur d’objet d’affichage.
Les paramètres et la syntaxe de cette méthode sont identiques à ceux de la méthode
Les paramètres et la syntaxe de cette méthode sont identiques à ceux de la méthode
Pour les éléments de graphique Cartesian, deux valeurs sont en général transmises. La première valeur correspond à l’axe horizontal et la deuxième à l’axe vertical.
Dans le cas de graphiques polaires, la première valeur correspond à l’axe angulaire et la deuxième à l’axe radial.
Les paramètres et la syntaxe de cette méthode sont identiques à ceux de la méthode
Les différents types de graphiques déterminent la manière dont cette transformation est réalisée. Le point doit être relatif à l’espace de coordonnées du graphique.
Par exemple :
var lbl:Label = new Label(); lbl.text = "Last Month"; canvas.addChild(lbl); canvas.updateDataChild(lbl,"Feb",200);
Les classes implémentent cette interface pour fournir des fonctionnalités de définition de plage de valeurs.
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.
La taille minimale d’un graphique est de 20,20 pixels.
La taille maximale d’un graphique n’a pas de limite.
La taille recommandée d’un graphique est de 400,400 pixels.
<mx:CartesianChart>
tag inherits all the
properties of its parent classes and adds the following properties:
<mx:CartesianChart Properties computedGutters="No default" dataRegion="Rectangle; no default" horizontalAxis="Axis; no default" horizontalAxisRatio=".33" horizontalAxisRenderers="Array; no default" selectedChartItems="Array; no default" verticalAxis="Axis; no default" verticalAxisRatio=".33" verticalAxisRenderers="Array; no default" Styles axisTitleStyleName="Style; no default" gridLinesStyleName="Style; no default" gutterBottom="No default" gutterLeft="No default" gutterRight="No default" gutterTop="No default" horizontalAxisStyleNames=Array; no default" verticalAxisStyleNames = Array; no default" />]]>
Il s’agit d’un accesseur de bas niveau.
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.
Si vous implémentez un type de série personnalisé, il n’est généralement pas nécessaire de remplacer cette méthode. En revanche, vous devez remplacer l’accesseur
Il s’agit d’un accesseur de bas niveau.
La fonction
function_name (series:Series, item:Object, fieldName:String):Object { ... }
La propriété
{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; }
La fonction
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
Les différentes séries déterminent la liste des éléments à renvoyer.
Une série d’empilement personnalisée implémente la méthode
Si vous ajoutez un objet enfant qui est déjà doté d’un autre conteneur d’objet d’affichage en tant que parent, il est supprimé de la liste d’enfants de cet autre conteneur d’objet d’affichage.
Pour les éléments de graphique Cartesian, deux valeurs sont en général transmises. La première valeur correspond à l’axe horizontal et la deuxième à l’axe vertical.
Dans le cas de graphiques polaires, la première valeur correspond à l’axe angulaire et la deuxième à l’axe radial.
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.
Les différents types de graphiques déterminent la manière dont cette transformation est réalisée. Le point doit être relatif à l’espace de coordonnées du graphique.
Un graphique peut théoriquement contenir plusieurs objets DataTransform superposés. Vous pouvez ainsi afficher un graphique dans lequel plusieurs jeux de données utilisant différentes plages de valeurs sont rendus dans une même zone. Supposons que vous souhaitez afficher les recettes mensuelles et comparer cette valeur au nombre de produits vendus. Si les recettes sont généralement exprimées en millions et le nombre de produits vendus en milliers, il est difficile de rendre ces valeurs de façon efficace en utilisant une même plage de valeurs. En utilisant plusieurs objets DataTransform pour réaliser une incrustation et rendre les valeurs à l’aide de plages différentes, l’utilisateur final peut comparer l’évolution des valeurs.
Un graphique peut contenir un seul ensemble d’objets DataTransform.
La plupart du temps, vous utiliserez l’objet ChartBase, qui masque l’existence de l’objet DataTransform entre le graphique et les objets de glyphe et d’axe qu’il contient. Si vous créez vos propres objets ChartElement, vous devez comprendre les méthodes de la classe DataTransform pour implémenter correctement leur élément.
Pour collecter les valeurs importantes pour l’axe horizontal d’un objet CartesianTransform, transmettez la valeur 0. Pour collecter les valeurs pour l’axe vertical, transmettez la valeur 1.
Flex components inherit the following properties from the DualStyleObject class:
<mx:tagname internalStyleName="Style; No default" >]]>