DataPoint Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет точку данных, хранящуюся в DataPointCollection классе.
public ref class DataPoint : System::Windows::Forms::DataVisualization::Charting::DataPointCustomProperties
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataVisualization.Charting.DataPointConverter, System.Windows.Forms.DataVisualization.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35")]
public class DataPoint : System.Windows.Forms.DataVisualization.Charting.DataPointCustomProperties
[<System.ComponentModel.TypeConverter("System.Windows.Forms.Design.DataVisualization.Charting.DataPointConverter, System.Windows.Forms.DataVisualization.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35")>]
type DataPoint = class
inherit DataPointCustomProperties
Public Class DataPoint
Inherits DataPointCustomProperties
- Наследование
- Атрибуты
Комментарии
Класс DataPoint хранит свойства, связанные с данными, а также значениями точек данных. Например, точка данных имеет значение, но также имеет свойство цвета, свойство фонового изображения, свойство градиента фона и т. д. Дополнительные сведения о свойствах точки данных см. в DataPointCustomProperties разделе обзора класса.
Каждая точка данных состоит из X-значения и одного или нескольких Y-значений. Значение X может быть равно нулю или явно задать это значение.
Для всех типов диаграмм, кроме пузырьков, свечей и фондовых диаграмм, требуется только один Y-значение на точку. Для этих типов диаграмм требуется несколько значений Y, так как одна точка данных состоит из нескольких значений. Например, для построения одного столбца фондовой диаграммы требуются четыре значения: высокие, низкие, открытые и закрываемые значения.
Данные можно добавлять в любое время разработки или во время выполнения; вы также можете использовать привязку данных во время выполнения.
Конструкторы
| Имя | Описание |
|---|---|
| DataPoint() |
Инициализирует новый экземпляр класса DataPoint. |
| DataPoint(Double, Double) |
Инициализирует новый экземпляр DataPoint класса с указанным значением X и Y. |
| DataPoint(Double, Double[]) |
Инициализирует новый экземпляр DataPoint класса с указанным значением X и массивом Y-значений. |
| DataPoint(Double, String) |
Инициализирует новый экземпляр DataPoint класса с указанным значением X и Y-значениями. |
| DataPoint(Series) |
Инициализирует новый экземпляр DataPoint класса и задает Series то, к которому принадлежит точка данных. |
Свойства
| Имя | Описание |
|---|---|
| AxisLabel |
Возвращает или задает текст метки оси X для точки данных, ряда или пустой точки. Это свойство используется только в том случае, если пользовательская метка не указана для соответствующего Axis объекта. (Унаследовано от DataPointCustomProperties) |
| BackGradientStyle |
Возвращает или задает стиль фонового градиента. (Унаследовано от DataPointCustomProperties) |
| BackHatchStyle |
Возвращает или задает стиль штриховки фона. (Унаследовано от DataPointCustomProperties) |
| BackImage |
Возвращает или задает фоновое изображение точки данных. (Унаследовано от DataPointCustomProperties) |
| BackImageAlignment |
Возвращает или задает выравнивание фонового изображения, используемого с режимом Unscaled рисования. (Унаследовано от DataPointCustomProperties) |
| BackImageTransparentColor |
Возвращает или задает цвет, который будет заменен прозрачным цветом при рисовании фонового изображения. (Унаследовано от DataPointCustomProperties) |
| BackImageWrapMode |
Возвращает или задает режим рисования фонового изображения. (Унаследовано от DataPointCustomProperties) |
| BackSecondaryColor |
Возвращает или задает дополнительный цвет фона. (Унаследовано от DataPointCustomProperties) |
| BorderColor |
Возвращает или задает цвет границы точки данных. (Унаследовано от DataPointCustomProperties) |
| BorderDashStyle |
Возвращает или задает стиль границы точки данных. (Унаследовано от DataPointCustomProperties) |
| BorderWidth |
Возвращает или задает ширину границы точки данных. (Унаследовано от DataPointCustomProperties) |
| Color |
Возвращает или задает цвет точки данных. (Унаследовано от DataPointCustomProperties) |
| CustomProperties |
Возвращает или задает настраиваемые свойства точки данных. Настраиваемые свойства можно указать в следующем формате: AttrName1=Value1, AttrName2=Value2 ... (Унаследовано от DataPointCustomProperties) |
| CustomPropertiesExtended |
Возвращает или задает расширенные настраиваемые свойства точки данных. Расширенные настраиваемые свойства можно указать в следующем формате: AttrName1=Value1, AttrName2=Value2... (Унаследовано от DataPointCustomProperties) |
| Font |
Возвращает или задает шрифт точки данных. (Унаследовано от DataPointCustomProperties) |
| IsEmpty |
Возвращает или задает флаг, указывающий, помечена ли точка данных как пустая. |
| IsValueShownAsLabel |
Возвращает или задает флаг, указывающий, следует ли отображать значение точки данных на метках. (Унаследовано от DataPointCustomProperties) |
| IsVisibleInLegend |
Возвращает или задает флаг, указывающий, отображается ли элемент в условных обозначениях. (Унаследовано от DataPointCustomProperties) |
| 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) |
| LegendText |
Возвращает или задает текст элемента в условных обозначениях. (Унаследовано от DataPointCustomProperties) |
| LegendToolTip |
Возвращает или задает подсказку элемента в условных обозначениях. (Унаследовано от DataPointCustomProperties) |
| MarkerBorderColor |
Возвращает или задает цвет границы маркера. (Унаследовано от DataPointCustomProperties) |
| MarkerBorderWidth |
Возвращает или задает ширину границы маркера. (Унаследовано от DataPointCustomProperties) |
| MarkerColor |
Возвращает или задает цвет маркера. (Унаследовано от DataPointCustomProperties) |
| MarkerImage |
Возвращает или задает изображение маркера. (Унаследовано от DataPointCustomProperties) |
| MarkerImageTransparentColor |
Получает или задает цвет, который будет заменен прозрачным цветом при рисовании изображения маркера. (Унаследовано от DataPointCustomProperties) |
| MarkerSize |
Возвращает или задает размер маркера. (Унаследовано от DataPointCustomProperties) |
| MarkerStyle |
Возвращает или задает стиль маркера. (Унаследовано от DataPointCustomProperties) |
| Name |
Возвращает или задает имя точки данных. |
| Tag |
Возвращает или задает объект, связанный с этим элементом диаграммы. (Унаследовано от ChartElement) |
| ToolTip |
Возвращает или задает подсказку. (Унаследовано от DataPointCustomProperties) |
| XValue |
Возвращает или задает значение X точки данных. |
| YValues |
Возвращает или задает значения Y точки данных. |
Методы
| Имя | Описание |
|---|---|
| Clone() |
Возвращает новый экземпляр, который является точной копией точки данных. |
| DeleteCustomProperty(String) |
Удаляет настраиваемое свойство точки данных с указанным именем. (Унаследовано от DataPointCustomProperties) |
| Dispose() |
Освобождает ресурсы, используемые параметром ChartElement. (Унаследовано от ChartElement) |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые ChartElement и при необходимости освобождает управляемые ресурсы. (Унаследовано от ChartElement) |
| Equals(Object) |
Определяет, равен ли указанный параметр Object текущему ChartElement. (Унаследовано от ChartElement) |
| GetCustomProperty(String) |
Возвращает настраиваемое свойство точки данных с указанным именем. (Унаследовано от DataPointCustomProperties) |
| GetHashCode() |
Возвращает хэш-функцию для определенного типа. (Унаследовано от ChartElement) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| GetValueByName(String) |
Возвращает точку данных, указанную его именем. Это вспомогательные функции. |
| IsCustomPropertySet(String) |
Определяет, задано ли настраиваемое свойство с указанным именем. (Унаследовано от DataPointCustomProperties) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ResetIsValueShownAsLabel() |
Сбрасывает настраиваемое свойство в значение по умолчанию. (Унаследовано от DataPointCustomProperties) |
| ResetIsVisibleInLegend() |
Сбрасывает настраиваемое свойство в значение по умолчанию. (Унаследовано от DataPointCustomProperties) |
| SetCustomProperty(String, String) |
Задает настраиваемое свойство точки данных. (Унаследовано от DataPointCustomProperties) |
| SetDefault(Boolean) |
Задает свойства точки данных по умолчанию. Указывает, следует ли очистить предыдущие значения свойств. (Унаследовано от DataPointCustomProperties) |
| SetValueXY(Object, Object[]) |
Задает значение X и одно или несколько значений Y точки данных. |
| SetValueY(Object[]) |
Задает значения Y для одной точки данных. |
| ToString() |
Возвращает строку, представляющую текущий Object. (Унаследовано от ChartElement) |