Anotações em controles de gráfico

Artigo
06/10/2015

O Chart.Annotations propriedade de coleção contém todas as anotações (Annotation objetos) no controle do gráfico. Você pode adicionar diferentes tipos de anotações à coleção. Eles são úteis como comentários na imagem de gráfico para falar mais sobre pontos de dados. Você também pode usá-las para desenhar formas personalizadas (PolylineAnnotation, PolygonAnntation, ou AnnotationGroup).

Dica

Limitações se aplicam ao usar anotações em uma área do gráfico 3D.Para obter mais informações, consulte gráficos 3D.

Existem diferentes tipos de anotações:

Somente de forma (como LineAnnotation)
Somente texto (como TextAnnotation)
Formas e texto (como EllipseAnnotation)
Grupo (como AnnotationGroup)

Adicionando anotações em tempo de execução

Para adicionar uma anotação ao controle do gráfico em tempo de execução, use o Add método o Chart.Annotations objeto. O código a seguir demonstra como adicionar um LineAnnotation ao controle do gráfico.

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

Anotações de posicionamento

Posicione uma anotação das seguintes maneiras:

Posicione-o em qualquer lugar no gráfico imagem usando o Annotation.X e Annotation.Y propriedades.
Ancorá-lo para uma posição na imagem de gráfico usando o Annotation.AnchorX e Annotation.AnchorY propriedades, em seguida, usar rótulos inteligentes para posicioná-la automaticamente em outros rótulos. Para obter mais informações, consulte rótulos.
Ancore suas coordenadas X e Y para os eixos X e Y na área de plotagem. Para fazer isso, defina o Annotation.AxisX e Annotation.AxisY propriedades para os eixos que você deseja usar e, em seguida, especifique o Annotation.AnchorX e Annotation.AnchorY propriedades.

O seguinte código usa primários X e eixos Y para posicionar a anotação nas coordenadas do eixo (1,20) na área de plotagem.
```
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;
```
Ancorar a anotação a um ponto de dados com o Annotation.AnchorDataPoint propriedade.

O código a seguir fixa a anotação para o segundo ponto de dados da primeira série.
```
Chart1.Annotations(0).AnchorDataPoint = Chart1.Series(0).Points(1)
```
```
Chart1.Annotations[0].AnchorDataPoint = Chart1.Series[0].Points[1];
```
Dica

Se você ancorar a anotação a um ponto de dados, você pode usar palavras-chave do ponto de dados em que a anotação Text, Tooltip, Url, e MapAreaAttributes propriedades.Para obter mais informações, consulte palavras-chave.

Anotações de dimensionamento

Dimensione uma anotação das seguintes maneiras:

Use Annotation.Width e Annotation.Height em tempo de design.
Use Annotation.Right e Annotation.Bottom em tempo de execução.

Consulte também

Referência

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

Elementos do gráfico

Partilhar via