Annotations dans les contrôles Chart

Article
08/04/2015

La propriété de collection Chart.Annotations contient toutes les annotations (des objetsAnnotation) du contrôle Chart.Vous pouvez ajouter à la collection d'autres types d'annotations.Elles sont utiles dans l'image du graphique en tant que commentaires visant à entrer dans le détail de certains points de données.Vous pouvez également les utiliser pour dessiner des formes personnalisées (PolylineAnnotation, PolygonAnntation ou AnnotationGroup).

Notes

Des limitations s'appliquent lors de l'utilisation d'annotations à l'intérieur d'une zone de graphique 3D.Pour plus d'informations, consultez Graphiques 3D.

Il existe différents types d'annotations :

Forme seule (comme LineAnnotation)
Texte seul (comme TextAnnotation)
Texte et forme (comme EllipseAnnotation)
Groupe (comme AnnotationGroup)

Ajout d'annotations au moment de l'exécution

Pour ajouter une annotation au contrôle Chart au moment de l'exécution, utilisez la méthode Add de l'objet Chart.Annotations.Le code suivant illustre l'ajout de LineAnnotation au contrôle Chart.

Imports System.Web.UI.DataVisualization.Charting
...
Dim myLine as LineAnnotation  = New LineAnnotation()
myLine.Name = "myLine"
myLine.X = 3
myLine.Y = 3
Chart1.Annotations.Add(myLine)

using System.Web.UI.DataVisualization.Charting;
...
LineAnnotation myLine = new LineAnnotation(); 
myLine.Name = "myLine"; 
myLine.X = 3;
myLine.Y = 3;
Chart1.Annotations.Add(myLine);

Positionnement des annotations

Vous pouvez positionner une annotation de différentes façons :

Positionnez-la n'importe où dans l'image du graphique à l'aide des propriétés Annotation.X et Annotation.Y.
Ancrez-la à en endroit situé dans l'image du graphique à l'aide des propriétés Annotation.AnchorX et Annotation.AnchorY, puis utilisez des étiquettes actives pour la positionner automatiquement autour d'autres étiquettes.Pour plus d'informations, consultez Étiquettes.
Ancrez ses coordonnées X et Y aux axes des Y et des X dans la zone de traçage.Pour cela, affectez aux propriétés Annotation.AxisX et Annotation.AxisY les axes à utiliser, puis spécifiez les propriétés Annotation.AnchorX et Annotation.AnchorY.

Le code suivant utilise les axes des X et des Y principaux pour positionner l'annotation aux coordonnées d'axe (1,20) dans la zone de traçage.
```
Chart1.Annotations(0).AxisX = Chart1.ChartAreas(0).AxisX;
Chart1.Annotations(0).AxisY = Chart1.ChartAreas(0).AxisY;
Chart1.Annotations(0).AnchorX = 1;
Chart1.Annotations(0).AnchorY = 20;
```
```
Chart1.Annotations[0].AxisX = Chart1.ChartAreas[0].AxisX;
Chart1.Annotations[0].AxisY = Chart1.ChartAreas[0].AxisY;
Chart1.Annotations[0].AnchorX = 1;
Chart1.Annotations[0].AnchorY = 20;
```
Ancrez l'annotation à un point de données avec la propriété Annotation.AnchorDataPoint.

Le code suivant ancre l'annotation au deuxième point de données de la première série.
```
Chart1.Annotations(0).AnchorDataPoint = Chart1.Series(0).Points(1)
```
```
Chart1.Annotations[0].AnchorDataPoint = Chart1.Series[0].Points[1];
```
Notes

Si vous ancrez l'annotation à un point de données, vous pouvez utiliser les mots clés du point de données dans les propriétés Text, Tooltip, Url et MapAreaAttributes de l'annotation.Pour plus d'informations, consultez Mots clés.

Redimensionnement d'annotations

Redimensionnez une annotation en procédant comme suit :

Utilisez Annotation.Width et Annotation.Height au moment de la conception.
Utilisez Annotation.Right et Annotation.Bottom au moment de l'exécution.

Voir aussi

Référence

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

Éléments de graphique

Partager via