Annotazioni

Articolo
08/31/2012

La proprietà di raccolta Chart.Annotations contiene tutte le annotazioni (oggetti Annotation) presenti nel controllo Chart.È possibile aggiungere diversi tipi di annotazioni alla raccolta.Le annotazioni sono utili per introdurre commenti nell'immagine del grafico per l'analisi dei punti dati.Le annotazioni possono inoltre essere utilizzate per disegnare forme personalizzate (PolylineAnnotation, PolygonAnntation o AnnotationGroup).

[!NOTA]

Si applicano alcune limitazioni quando si utilizzano annotazioni all'interno di aree grafico 3D.Per ulteriori informazioni, vedere Grafici 3D.

Esistono diversi tipi di annotazioni:

Solo forma (ad esempio, LineAnnotation)
Solo testo (ad esempio, TextAnnotation)
Testo e forma (ad esempio, EllipseAnnotation)
Gruppo (ad esempio, AnnotationGroup)

Aggiunta di annotazioni in fase di esecuzione

Per aggiungere un'annotazione al controllo Chart in fase di esecuzione, utilizzare il metodo Add dell'oggetto Chart.Annotations.Nell'esempio di codice riportato di seguito viene illustrata l'aggiunta di un oggetto LineAnnotation a un controllo 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);

Posizionamento delle annotazioni

Per posizionare un'annotazione utilizzare uno dei modi riportati di seguito.

Posizionare l'annotazione in un punto qualunque dell'immagine del grafico utilizzando le proprietà Annotation.X e Annotation.Y.
Ancorare l'annotazione a una posizione nell'immagine del grafico utilizzando le proprietà Annotation.AnchorX e Annotation.AnchorY, quindi utilizzare Smart Label per posizionarla attorno alle altre etichette.Per ulteriori informazioni, vedere Etichette.
Ancorare le coordinate X e Y dell'annotazione ai rispettivi assi X e Y nell'area del tracciato.A questo scopo, impostare le proprietà Annotation.AxisX e Annotation.AxisY sugli assi che si desidera utilizzare, quindi specificare le proprietà Annotation.AnchorX e Annotation.AnchorY.

Nell’esempio di codice riportato di seguito vengono utilizzati gli assi X e Y primari per posizionare l'annotazione alle coordinate degli assi (1,20) nell'area del tracciato.
```
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;
```
Ancorare l'annotazione a un punto dati utilizzando la proprietà Annotation.AnchorDataPoint.

Nell’esempio di codice riportato di seguito l'annotazione viene ancorata al secondo punto dati della prima serie.
```
Chart1.Annotations(0).AnchorDataPoint = Chart1.Series(0).Points(1)
```
```
Chart1.Annotations[0].AnchorDataPoint = Chart1.Series[0].Points[1];
```
[!NOTA]

Se l'annotazione viene ancorata a un punto dati, è possibile utilizzare le parole chiave del punto dati nelle proprietà Text, Tooltip, Url e MapAreaAttributes dell'annotazione.Per ulteriori informazioni, vedere Parole chiave.

Dimensionamento delle annotazioni

Per dimensionare un'annotazione utilizzare uno dei modi riportati di seguito.

Utilizzare le proprietà Annotation.Width e Annotation.Height in fase di progettazione.
Utilizzare le proprietà Annotation.Right e Annotation.Bottom in fase di esecuzione.

Vedere anche

Riferimento

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

Elementi del grafico

Condividi tramite