自訂屬性

  • 發行項

Chart 控制項中的每個圖表類型都包含一組自訂屬性。自訂屬性可讓您自訂圖表的外觀及操作。它們是透過 Series 物件及其關聯 DataPoint 物件的 CustomProperties 屬性實作。

[!附註]

每個自訂屬性適用於一組特定的圖表類型。

Chart 控制項自訂屬性擁有下列特性：

  • 根據圖表類型，可對圖表的 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

概念

自訂屬性清單