通过

图表控件中的批注

  • 项目

Chart.Annotations 集合属性包含图表控件中的所有批注（Annotation 对象）。可以将不同类型的批注添加到集合中。批注可以用作图表图片中的注释以详细说明数据点。也可以使用批注来绘制自定义形状（PolylineAnnotation、PolygonAnntation 或 AnnotationGroup）。

备注

在三维图表区中使用批注时存在一些限制。有关更多信息，请参见三维图表。

批注有多种类型：

  • 纯形状（例如 LineAnnotation）。

  • 纯文本（例如 TextAnnotation）

  • 文本和形状（例如 EllipseAnnotation）

  • 组（例如 AnnotationGroup）

在运行时添加批注

若要在运行时向图表控件添加批注，请使用 Chart.Annotations 对象中的 Add 方法。下面的代码演示如何向图表控件添加 LineAnnotation。

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

放置批注

批注可通过以下方式放置：

  • 使用 Annotation.X 和 Annotation.Y 属性将批注放置在图表图片中的任意位置。

  • 使用 Annotation.AnchorX 和 Annotation.AnchorY 属性将批注固定在图表图片中的某个位置，然后使用智能标签自动将其放置在其他标签周围。有关更多信息，请参见标签。

  • 将批注的 X 和 Y 坐标固定在绘图区中的 X 和 Y 轴上。为此，请将 Annotation.AxisX 和 Annotation.AxisY 属性设置为要使用的轴，然后指定 Annotation.AnchorX 和 Annotation.AnchorY 属性。

    下面的代码使用主 X 和 Y 轴将批注放置在绘图区中的轴坐标 (1,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;

    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;

  • 使用 Annotation.AnchorDataPoint 属性将批注固定在某个数据点。

    下面的代码将批注固定在第一个序列的第二个数据点。

    Chart1.Annotations(0).AnchorDataPoint = Chart1.Series(0).Points(1)

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

    备注

    如果将批注固定在某个数据点，则可以在批注的 Text、Tooltip、Url 和 MapAreaAttributes 属性中使用该数据点的关键字。有关更多信息，请参见关键字。

调整批注大小

批注大小可通过以下方式调整：

  • 在设计时使用 Annotation.Width 和 Annotation.Height。

  • 在运行时使用 Annotation.Right 和 Annotation.Bottom。

请参见

参考

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

图表元素