다음을 통해 공유

사용자 지정 속성(차트 컨트롤)

  • 아티클

차트 컨트롤의 각 차트 종류에는 사용자 지정 속성 집합이 있습니다. 사용자 지정 속성을 사용하면 차트의 모양과 느낌을 사용자 지정할 수 있습니다. 사용자 지정 속성은 Series 개체와 관련 DataPoint 개체 모두의 CustomProperties 속성을 사용하여 구현됩니다.

참고

각 사용자 지정 속성은 특정 차트 종류 집합에 적용됩니다.

차트 컨트롤 사용자 지정 속성의 특징은 다음과 같습니다.

  • 차트 종류에 따라 적용 가능한 사용자 지정 속성을 차트의 Series 개체나 관련 DataPoint 개체 또는 두 개체 모두에 설정할 수 있습니다. 사용자 지정 속성을 차트의 Series 및 DataPoint 개체에 모두 적용할 수 있는 경우 계열에 대해 설정되는 모든 사용자 지정 속성이 해당 계열에 포함된 모든 데이터 요소에 적용됩니다.

  • DataPoint 개체에 적용되는 사용자 지정 속성은 Series 개체에 적용되는 사용자 지정 속성보다 더 높은 우선 순위를 갖습니다. Series 개체와 해당 DataPoint 개체 중 하나에 대해 동일한 사용자 지정 속성이 설정되는 경우 DataPoint 개체의 설정이 우선합니다.

  • 사용자 지정 속성 이름은 대/소문자를 구분합니다.

  • 사용자 지정 속성 값은 문자열입니다.

  • 사용자 지정 속성 값에 쉼표가 있는 경우 각 쉼표 앞에 이스케이프 '\' 문자를 입력해야 합니다.

각 사용자 지정 속성에 대한 자세한 내용과 예제는 사용자 지정 속성 목록을 참조하십시오.

사용자 지정 속성 액세스

사용자 지정 속성은 Visual Studio의 속성 창에 표시되지 않습니다. 사용자 지정 속성을 프로그래밍 방식으로 액세스하려면 CustomProperties 속성을 지정할 필요가 없습니다. Series 또는 DataPoint 개체에 인덱서를 추가하고 사용자 지정 속성의 이름을 인덱스로 사용하여 특정 이름/값 쌍을 가져와서 설정하면 됩니다. 이 메서드를 사용하면 해당 사용자 지정 속성에만 액세스할 수 있습니다.

Series 및 DataPoint 개체는 사용자 지정 속성에 액세스하는 다른 메서드를 제공합니다. 예를 들어 IsCustomPropertySet, SetCustomProperty, SetCustomProperty 및 DeleteCustomProperty 메서드를 제공합니다.

다음 코드에서는 원형 차트의 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

관련 자료

사용자 지정 속성 목록