Series Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет атрибуты точек данных и рядов для хранения.
public ref class Series : System::Windows::Forms::DataVisualization::Charting::DataPointCustomProperties
public class Series : System.Windows.Forms.DataVisualization.Charting.DataPointCustomProperties
type Series = class
inherit DataPointCustomProperties
Public Class Series
Inherits DataPointCustomProperties
- Наследование
Комментарии
Series Объект представляет ряд данных и хранится в SeriesCollection классе.
Объект Series хранит DataPoint объекты с помощью DataPointCollection класса. Он также сохраняет атрибуты ряда данных. Например, ряд данных имеет атрибут цвета, атрибут фонового изображения, атрибут градиента фона и т. д.
Объекты DataPoint , принадлежащие серии, также имеют свои собственные атрибуты. Как правило, если для точки данных задан тот же атрибут и ряд, к которому он принадлежит, атрибут точки данных имеет приоритет.
Ряд не обязательно отображается на диаграмме; Он может хранить значения точек данных, которые используются для вычисления, из которого создается другая серия, а затем отображается. Например, серия A, которая отображается, может быть результатом добавления точек данных серии B и серии C вместе, хотя ни из этих рядов не выполняется график. Чтобы нарисовать Series объект, свойству необходимо задать имя объекта, ChartArea используемого ChartArea для построения ряда.
При создании ряда он автоматически назначается ChartArea объекту с именем Default или первой доступной области диаграммы в коллекции областей диаграммы, если объект Default не существует.
Чтобы отключить отображение ряда, задайте для свойства ChartArea строку нулевой длины.
Свойство ChartType определяет тип диаграммы, которая будет использоваться для построения этой серии, если она нарисована.
Конструкторы
| Имя | Описание |
|---|---|
| Series() |
Инициализирует новый экземпляр класса Series. |
| Series(String, Int32) |
Инициализирует новый экземпляр Series класса с указанным именем и максимальным числом Y-значений. |
| Series(String) |
Инициализирует новый экземпляр Series класса с указанным именем ряда. |
Свойства
| Имя | Описание |
|---|---|
| AxisLabel |
Возвращает или задает текст метки оси для ряда. |
| BackGradientStyle |
Возвращает или задает стиль фонового градиента. (Унаследовано от DataPointCustomProperties) |
| BackHatchStyle |
Возвращает или задает стиль штриховки фона. (Унаследовано от DataPointCustomProperties) |
| BackImage |
Возвращает или задает фоновое изображение точки данных. (Унаследовано от DataPointCustomProperties) |
| BackImageAlignment |
Возвращает или задает выравнивание фонового изображения, используемого с режимом Unscaled рисования. (Унаследовано от DataPointCustomProperties) |
| BackImageTransparentColor |
Возвращает или задает цвет, который будет заменен прозрачным цветом при рисовании фонового изображения. (Унаследовано от DataPointCustomProperties) |
| BackImageWrapMode |
Возвращает или задает режим рисования фонового изображения. (Унаследовано от DataPointCustomProperties) |
| BackSecondaryColor |
Возвращает или задает дополнительный цвет фона. (Унаследовано от DataPointCustomProperties) |
| BorderColor |
Возвращает или задает цвет границы точки данных. (Унаследовано от DataPointCustomProperties) |
| BorderDashStyle |
Возвращает или задает стиль границы точки данных. (Унаследовано от DataPointCustomProperties) |
| BorderWidth |
Возвращает или задает ширину границы точки данных. (Унаследовано от DataPointCustomProperties) |
| ChartArea |
Возвращает или задает имя объекта, используемого ChartArea для построения ряда данных, если таковой есть. |
| ChartType |
Возвращает или задает тип диаграммы ряда. |
| ChartTypeName |
Возвращает или задает имя типа диаграммы, используемого для рисования ряда. |
| Color |
Возвращает или задает цвет точки данных. (Унаследовано от DataPointCustomProperties) |
| CustomProperties |
Возвращает или задает настраиваемые свойства точки данных. Настраиваемые свойства можно указать в следующем формате: AttrName1=Value1, AttrName2=Value2 ... (Унаследовано от DataPointCustomProperties) |
| CustomPropertiesExtended |
Возвращает или задает расширенные настраиваемые свойства точки данных. Расширенные настраиваемые свойства можно указать в следующем формате: AttrName1=Value1, AttrName2=Value2... (Унаследовано от DataPointCustomProperties) |
| EmptyPointStyle |
Возвращает или задает стиль рисования точек, помеченных как пустые. |
| Enabled |
Возвращает или задает флаг, указывающий, будет ли ряд отображаться на отрисованной диаграмме. |
| Font |
Возвращает или задает шрифт точки данных. (Унаследовано от DataPointCustomProperties) |
| IsValueShownAsLabel |
Возвращает или задает флаг, указывающий, следует ли отображать значение точки данных на метках. (Унаследовано от DataPointCustomProperties) |
| IsVisibleInLegend |
Возвращает или задает флаг, указывающий, отображается ли элемент в условных обозначениях. (Унаследовано от DataPointCustomProperties) |
| IsXValueIndexed |
Возвращает или задает флаг, указывающий, будут ли индексы точек данных использоваться для X-значений. |
| Item[Int32] |
DataPointCustomProperties Возвращает объект по его позиции в индексе. (Унаследовано от DataPointCustomProperties) |
| Item[String] |
Возвращает или задает DataPointCustomProperties объект по имени. (Унаследовано от DataPointCustomProperties) |
| Label |
Возвращает или задает текст метки точки данных. (Унаследовано от DataPointCustomProperties) |
| LabelAngle |
Возвращает или задает угол метки точки данных. (Унаследовано от DataPointCustomProperties) |
| LabelBackColor |
Возвращает или задает цвет фона метки точки данных. (Унаследовано от DataPointCustomProperties) |
| LabelBorderColor |
Возвращает или задает цвет границы метки точки данных. (Унаследовано от DataPointCustomProperties) |
| LabelBorderDashStyle |
Возвращает или задает стиль границы метки. (Унаследовано от DataPointCustomProperties) |
| LabelBorderWidth |
Возвращает или задает ширину границы метки. (Унаследовано от DataPointCustomProperties) |
| LabelForeColor |
Возвращает или задает цвет текста метки. (Унаследовано от DataPointCustomProperties) |
| LabelFormat |
Возвращает или задает формат метки точки данных. (Унаследовано от DataPointCustomProperties) |
| LabelToolTip |
Возвращает или задает подсказку для метки точки данных. (Унаследовано от DataPointCustomProperties) |
| Legend |
Возвращает или задает имя ряда, связанного Legend с объектом. |
| LegendText |
Возвращает или задает текст элемента в условных обозначениях. (Унаследовано от DataPointCustomProperties) |
| LegendToolTip |
Возвращает или задает подсказку элемента в условных обозначениях. (Унаследовано от DataPointCustomProperties) |
| MarkerBorderColor |
Возвращает или задает цвет границы маркера. (Унаследовано от DataPointCustomProperties) |
| MarkerBorderWidth |
Возвращает или задает ширину границы маркера. (Унаследовано от DataPointCustomProperties) |
| MarkerColor |
Возвращает или задает цвет маркера. (Унаследовано от DataPointCustomProperties) |
| MarkerImage |
Возвращает или задает изображение маркера. (Унаследовано от DataPointCustomProperties) |
| MarkerImageTransparentColor |
Получает или задает цвет, который будет заменен прозрачным цветом при рисовании изображения маркера. (Унаследовано от DataPointCustomProperties) |
| MarkerSize |
Возвращает или задает размер маркера. (Унаследовано от DataPointCustomProperties) |
| MarkerStep |
Возвращает или задает значение, определяющее частоту отображения маркеров точек данных. |
| MarkerStyle |
Возвращает или задает стиль маркера. (Унаследовано от DataPointCustomProperties) |
| Name |
Возвращает или задает уникальное имя Series объекта. |
| Palette |
Возвращает или задает цветовую палитру Series объекта. |
| Points |
Возвращает коллекцию точек данных. |
| ShadowColor |
Возвращает или задает цвет тени ряда. |
| ShadowOffset |
Возвращает или задает смещение тени в пикселях ряда. |
| SmartLabelStyle |
Возвращает или задает стиль смарт-меток. |
| Tag |
Возвращает или задает объект, связанный с этим элементом диаграммы. (Унаследовано от ChartElement) |
| ToolTip |
Возвращает или задает подсказку. (Унаследовано от DataPointCustomProperties) |
| XAxisType |
Возвращает или задает тип оси X ряда. |
| XValueMember |
Возвращает или задает элемент источника данных диаграммы, используемого для привязки данных к X-значению ряда. |
| XValueType |
Возвращает или задает типы значений, которые отображаются вдоль оси X. |
| YAxisType |
Возвращает или задает тип оси Y ряда. |
| YValueMembers |
Возвращает или задает столбцы-члены источника данных диаграммы, используемого для привязки данных к значениям Y ряда. |
| YValuesPerPoint |
Возвращает или задает максимальное число Y-значений, которые DataPoint могут иметь объекты в объекте Series . |
| YValueType |
Возвращает или задает тип данных Y в точках данных, хранящихся рядом. |
Методы
| Имя | Описание |
|---|---|
| DeleteCustomProperty(String) |
Удаляет настраиваемое свойство точки данных с указанным именем. (Унаследовано от DataPointCustomProperties) |
| Dispose() |
Освобождает ресурсы, используемые параметром ChartElement. (Унаследовано от ChartElement) |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые Series и при необходимости освобождает управляемые ресурсы. |
| Equals(Object) |
Определяет, равен ли указанный параметр Object текущему ChartElement. (Унаследовано от ChartElement) |
| GetCustomProperty(String) |
Возвращает настраиваемое свойство точки данных с указанным именем. (Унаследовано от DataPointCustomProperties) |
| GetHashCode() |
Возвращает хэш-функцию для определенного типа. (Унаследовано от ChartElement) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| IsCustomPropertySet(String) |
Определяет, задано ли настраиваемое свойство с указанным именем. (Унаследовано от DataPointCustomProperties) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ResetIsValueShownAsLabel() |
Сбрасывает настраиваемое свойство в значение по умолчанию. (Унаследовано от DataPointCustomProperties) |
| ResetIsVisibleInLegend() |
Сбрасывает настраиваемое свойство в значение по умолчанию. (Унаследовано от DataPointCustomProperties) |
| SetCustomProperty(String, String) |
Задает настраиваемое свойство точки данных. (Унаследовано от DataPointCustomProperties) |
| SetDefault(Boolean) |
Задает свойства точки данных по умолчанию. Указывает, следует ли очистить предыдущие значения свойств. (Унаследовано от DataPointCustomProperties) |
| Sort(IComparer<DataPoint>) |
Сортирует точки в серии с помощью IComparer интерфейса. |
| Sort(PointSortOrder, String) |
Сортирует точки в серии, учитывая указанный порядок сортировки и значение для сортировки. |
| Sort(PointSortOrder) |
Сортирует точки данных в ряде, учитывая указанный порядок сортировки. |
| ToString() |
Возвращает строку, представляющую текущий Object. (Унаследовано от ChartElement) |