Заметки в элементах управления диаграммы

Статья
08/04/2015

Свойство коллекции Chart.Annotations содержит все заметки (объекты Annotation) в элементе управления диаграммы.В коллекцию можно добавлять заметки различного типа.Они полезны в качестве комментариев на изображении диаграммы и конкретизируют значения точек данных.С помощью заметок также можно рисовать фигуры произвольной формы (PolylineAnnotation, PolygonAnntation или AnnotationGroup).

Примечание

Во время использования заметок в трехмерной области диаграммы действуют ограничения.Дополнительные сведения см. в разделе Трехмерные диаграммы.

Далее представлены различные типы заметок.

Только фигуры (например, LineAnnotation)
Только текст (например, TextAnnotation)
Текст и фигура (например, EllipseAnnotation)
Группа (например, AnnotationGroup)

Добавление заметок во время выполнения

Чтобы добавить заметку в элемент управления диаграммы во время выполнения, используйте метод Add в объекте Chart.Annotations.В следующем коде показано добавление объекта 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

Элементы диаграммы