Anmerkungen (Diagrammsteuerelemente)

Artikel
02/27/2011

Die Chart.Annotations-Auflistungseigenschaft enthält alle Anmerkungen (Annotation-Objekte) im Diagrammsteuerelement. Sie können der Auflistung unterschiedliche Anmerkungstypen hinzufügen. Sie eignen sich als Kommentare im Diagrammbild mit näheren Angaben zu Datenpunkten. Sie können Anmerkungen auch verwenden, um benutzerdefinierte Formen (PolylineAnnotation, PolygonAnntation oder AnnotationGroup) zu zeichnen.

Tipp

Bei Verwendung von Anmerkungen in einer 3D-Diagrammfläche bestehen gewisse Einschränkungen. Weitere Informationen finden Sie unter 3D-Diagramme.

Es gibt verschiedene Typen von Anmerkungen:

Nur Form (z. B. LineAnnotation)
Nur Text (z. B. TextAnnotation)
Text und Form (z. B. EllipseAnnotation)
Gruppe (z. B. AnnotationGroup)

Hinzufügen von Anmerkungen zur Laufzeit

Um dem Diagrammsteuerelement zur Laufzeit eine Anmerkung hinzuzufügen, verwenden Sie die Add-Methode im Chart.Annotations-Objekt. Im folgenden Code wird das Hinzufügen einer LineAnnotation zum Diagrammsteuerelement veranschaulicht.

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);

Positionieren von Anmerkungen

Positionieren Sie eine Anmerkung wie folgt:

Positionieren Sie die Anmerkung an einer beliebigen Position im Diagrammbild mit der Annotation.X-Eigenschaft und der Annotation.Y-Eigenschaft.
Verankern Sie die Anmerkung an einer Position im Diagrammbild mit der Annotation.AnchorX-Eigenschaft und der Annotation.AnchorY-Eigenschaft, und positionieren Sie sie anschließend mithilfe von SmartLabels um andere Bezeichnungen. Weitere Informationen finden Sie unter Bezeichnungen.
Verankern Sie die X- und Y-Koordinate der Anmerkung an der X- und Y-Achse in der Zeichnungsfläche. Legen Sie hierzu die Eigenschaften Annotation.AxisX und Annotation.AxisY auf die gewünschten Achsen fest, und geben Sie die Eigenschaften Annotation.AnchorX und Annotation.AnchorY an.

Im folgenden Code werden die primäre X- und Y-Achse verwendet, um die Anmerkung an Achsenkoordinaten (1,20) in der Zeichnungsfläche zu positionieren.
```
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;
```
Verankern Sie die Anmerkung an einem Datenpunkt mit der Annotation.AnchorDataPoint-Eigenschaft.

Im folgenden Code wird die Anmerkung am zweiten Datenpunkt der ersten Reihe verankert.
```
Chart1.Annotations(0).AnchorDataPoint = Chart1.Series(0).Points(1)
```
```
Chart1.Annotations[0].AnchorDataPoint = Chart1.Series[0].Points[1];
```
Tipp

Wenn Sie die Anmerkung an einem Datenpunkt verankern, können Sie die Schlüsselwörter des Datenpunkts in den Eigenschaften Text, Tooltip, Url und MapAreaAttributes der Anmerkung verwenden. Weitere Informationen finden Sie unter Schlüsselwörter.

Anpassen der Größe von Anmerkungen

Passen Sie die Größe einer Anmerkung wie folgt an:

Verwenden Sie Annotation.Width und Annotation.Height zur Entwurfszeit.
Verwenden Sie Annotation.Right und Annotation.Bottom zur Laufzeit.

Siehe auch

Verweis

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

Andere Ressourcen

Diagrammelemente

Freigeben über