Поделиться через

Пользовательские свойства в элементах управления диаграммы

  • Статья

Диаграмма каждого типа в элементе управления диаграммы содержит набор пользовательских свойств.Пользовательские свойства позволяют настраивать внешний вид диаграммы.Они реализуются с помощью свойства CustomProperties объектов Series и сопоставленных с ними объектов DataPoint.

Примечание

Каждое пользовательское свойство применяется к определенному набору типов диаграммы.

Пользовательские свойства элемента управления диаграммы обладают следующими характеристиками.

  • В зависимости от типа диаграммы можно задавать применимые пользовательские свойства в объектах Series диаграммы, в сопоставленных с ними объектах DataPoint или в объектах обоих типов.Если пользовательское свойство применимо и к объекту Series, и к объекту DataPoint, то любое пользовательское свойство, задаваемое для ряда, применяется ко всем точкам данных из этого ряда.

  • Пользовательские свойства, применяемые к объектам DataPoint, имеют приоритет выше, чем свойства, применяемые к объектам Series.Если для объекта Series и одного из содержащихся в нем объектов DataPoint задано одно и тоже пользовательское свойство, то предпочтение отдается объекту DataPoint.

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

  • Значениями пользовательских свойств являются строки.

  • Если значение пользовательского свойства содержит запятые, то перед каждой запятой необходимо указывать escape-символ «\».

Дополнительные сведения о каждом пользовательском свойстве, включая примеры, см. в разделе Список пользовательских свойств.

Доступ к пользовательским свойствам

Пользовательские свойства не отображаются в окне свойств Visual Studio.Для программного доступа к этим свойствам не нужно указывать свойство CustomProperties.Просто добавьте индексатор к объекту Series или DataPoint и используйте имя пользовательского свойства в качестве индекса, чтобы получить или установить определенную пару «имя-значение».Этот метод позволяет получить доступ только к нужному пользовательскому свойству.

Объекты Series и DataPoint предоставляют другие методы для доступа к пользовательским свойствам.Например, IsCustomPropertySet, SetCustomProperty, SetCustomProperty и DeleteCustomProperty.

В следующем коде выполняется доступ к пользовательскому свойству Exploded в объекте DataPoint круговой диаграммы, в качестве значения свойства устанавливается True, а затем проверяется значение свойства.

' Explode the first pie slice
Chart1.Series("Default").Points(0)("Exploded") = "True"
…
' Check if the the first pie slice is still exploded
If Chart1.Series("Default").Points(0)("Exploded") = "True"
    ' Do something
End If

// Explode the first pie slice
Chart1.Series["Default"].Points[0]["Exploded"] = "True"
…
// Check if the the first pie slice is still exploded
if (Chart1.Series["Default"].Points[0]["Exploded"] == "True")
{
    //Do something
}

См. также

Ссылки

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

Основные понятия

Список пользовательских свойств