Compartir a través de


Anotaciones en controles Chart

La propiedad de colección Chart.Annotations contiene todas las anotaciones (objetosAnnotation) del control Chart.Puede agregar tipos diferentes de anotaciones a la colección.Resultan útiles como comentarios en la imagen del gráfico para proporcionar información sobre puntos de datos.También se pueden usar para dibujar formas personalizadas (PolylineAnnotation, PolygonAnntation o AnnotationGroup).

Nota

Si las anotaciones se usan dentro de un área de gráfico 3D, se aplican algunas limitaciones.Para obtener más información, vea Gráficos 3D.

Existen diferentes tipos de anotaciones:

  • Solo forma (como LineAnnotation)

  • Solo texto (como TextAnnotation)

  • Texto y forma (como EllipseAnnotation)

  • Grupo (como AnnotationGroup)

Agregar anotaciones en tiempo de ejecución

Para agregar una anotación al control Chart en tiempo de ejecución, utilice el método Add en el objeto Chart.Annotations.El siguiente código muestra cómo agregar LineAnnotation al control 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);

Colocar anotaciones

La colocación de una anotación se puede realizar de las siguientes maneras:

  • Colóquela en cualquier parte de la imagen del gráfico mediante las propiedades Annotation.X y Annotation.Y.

  • Delimítela a una posición en la imagen del gráfico mediante las propiedades Annotation.AnchorX y Annotation.AnchorY; a continuación, utilice etiquetas inteligentes para colocarla automáticamente alrededor de otras etiquetas.Para obtener más información, vea Etiquetas.

  • Delimite sus coordenadas X e Y en los ejes X e Y del área de trazado.Para ello, establezca las propiedades Annotation.AxisX y Annotation.AxisY en los ejes que desea usar y, a continuación, especifique las propiedades Annotation.AnchorX y Annotation.AnchorY.

    El siguiente código utiliza los ejes X e Y principales para colocar la anotación en las coordenadas de eje (1,20) del área de trazado.

    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;
    
  • Delimita la anotación a un punto de datos con la propiedad Annotation.AnchorDataPoint.

    El siguiente código delimita la anotación al segundo punto de datos de la primera serie.

    Chart1.Annotations(0).AnchorDataPoint = Chart1.Series(0).Points(1)
    
    Chart1.Annotations[0].AnchorDataPoint = Chart1.Series[0].Points[1];
    

    Nota

    Si delimita la anotación a un punto de datos, puede utilizar las palabras clave del punto de datos en las propiedades Text, Tooltip, Url y MapAreaAttributes de la anotación.Para obtener más información, vea Palabras clave.

Ajustar el tamaño de las anotaciones

Puede ajustar el tamaño de las anotaciones de las siguientes maneras:

  • Utilice Annotation.Width y Annotation.Height en tiempo de diseño.

  • Utilice Annotation.Right y Annotation.Bottom en tiempo de ejecución.

Vea también

Referencia

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

Elemento de gráfico