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