自定义属性(图表控件)
图表控件中的每个图表类型都包含一组自定义属性。使用自定义属性可以自定义图表的外观。这些属性可使用 Series 对象及其关联 DataPoint 对象的 CustomProperties 属性来实现。
提示
每个自定义属性都适用于一组特定的图表类型。
图表控件自定义属性具有以下特征:
根据图表类型,您可以将适用的自定义属性设置为图表的 Series 对象和/或其关联 DataPoint 对象。如果某个自定义属性同时适用于图表的 Series 和 DataPoint 对象,则为序列设置的任何自定义属性都适用于该序列包含的所有数据点。
适用于 DataPoint 对象的自定义属性的优先级高于适用于 Series 对象的自定义属性。如果为某个 Series 对象及该对象的一个 DataPoint 对象设置了同一个自定义属性,则该 DataPoint 对象的设置优先。
自定义属性名称区分大小写。
自定义属性值是字符串。
如果自定义属性的值包含逗号,则必须在每个逗号前加一个转义字符“\”。
有关每个自定义属性的更多信息(包括示例),请参见自定义属性列表。
访问自定义属性
自定义属性在 Visual Studio 的“属性”窗口中不可见。若要以编程方式访问自定义属性,不需要指定 CustomProperties 属性。将一个索引器添加到 Series 或 DataPoint 对象,然后将自定义属性的名称用作索引,即可获取和设置特定名称/值对。通过这种方法,可以只访问该特定自定义属性。
Series 和 DataPoint 对象提供了其他一些方法用于访问自定义属性。例如:IsCustomPropertySet、SetCustomProperty、SetCustomProperty 和 DeleteCustomProperty。
下面的代码访问一个饼图的 DataPoint 对象中的 Exploded 自定义属性,并将其设置为 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