범례(차트 컨트롤)
범례를 사용하여 차트 그림에서 계열과 데이터 요소를 구별할 수 있습니다. 범례는 Chart.Legends 컬렉션 속성에 Legend 개체로 저장됩니다.
기본적으로 범례는 차트 영역에 도킹되지 않고 모든 차트 영역의 외부에 표시됩니다. Legend 개체의 DockedToChartArea 속성을 사용하여 범례를 차트 영역에 도킹할 수 있습니다. Series 개체의 Legend 속성을 사용하여 각 계열을 범례에 개별적으로 지정합니다.
대부분의 차트 종류에서 각 범례 항목은 그려진 계열을 나타냅니다. 원형, 도넛형, 깔때기형 또는 피라미드형 차트에서 각 범례 항목은 계열의 데이터 요소를 나타냅니다.
기본적으로 차트 컨트롤은 범례에서 두 개의 열을 자동으로 만듭니다. 한 열은 그려진 데이터의 색을 나타내고 다른 열에는 범례 텍스트가 표시됩니다. Series.LegendText 속성 또는 DataPoint.LegendText 속성에서 범례 텍스트를 지정할 수 있습니다.
런타임에 범례 추가
런타임에 차트에 범례를 추가하려면 범례가 해당 차트 영역에 도킹되고 데이터 계열에 지정되어 있으며 데이터 계열의 IsVisibleInLegend 속성이 true로 설정되어 있는지 확인합니다. 다음 코드에서는 이 작업을 보여 줍니다.
' Create a new legend called "Legend2".
Chart1.Legends.Add(New Legend("Legend2"))
' Set Docking chart of the legend to the Default chart area.
Chart1.Legends("Legend2").DockToChartArea = "Default"
' Assign the legend to Series1.
Chart1.Series("Series1").Legend = "Legend2"
Chart1.Series("Series1").IsVisibleInLegend = true
// Create a new legend called "Legend2".
Chart1.Legends.Add(new Legend("Legend2"));
// Set Docking of the Legend chart to the Default Chart Area.
chart1.Legends["Legend2"].DockToChartArea = "Default";
// Assign the legend to Series1.
Chart1.Series["Series1"].Legend = "Legend2";
Chart1.Series["Series1"].IsVisibleInLegend = true;
Legend 개체의 속성(예: Docking, Alignment, IsDockedInsideChartArea, Position, TableStyle, LegendStyle, MaximumAutoSize, Font, InterlacedRows)을 사용하여 범례 모양을 사용자 지정할 수 있습니다.
제목, 머리글 및 열 사용
다음 다이어그램에서는 다양한 범례 기능과 Legend 개체의 해당 속성을 보여 줍니다.
.gif "범례 기능을 보여 주는 그림")
참고
Chart.Legends 컬렉션에서 개별 범례 항목과 셀을 조정할 수 없습니다. 개별 범례 항목과 셀을 조정하려면 사용자 지정 범례 항목을 사용합니다.
Legend.Title 속성을 사용하여 범례 제목을 지정할 경우 \n을 사용하여 줄 바꿈을 나타냅니다. 키워드를 사용하여 데이터 계열에 따라 텍스트가 변경되도록 할 수도 있습니다. 자세한 내용은 키워드를 참조하십시오.
범례의 열 수를 사용자 지정하려면 Legend.CellColumns 컬렉션 속성을 사용합니다. 이 속성의 열은 자동으로 생성되는 각 범례 항목에 적용됩니다.
다음 코드에서는 Legend.CellColumns 속성과 키워드 사용을 보여 줍니다. 이 코드는 계열 이름, 계열 기호, 각 계열의 데이터 평균을 각각 나타내는 세 열을 추가합니다.
Chart1.Legends["Legend2"].CellColumns.Add(New LegendCellColumn("Name", LegendCellColumnType.Text, "#LEGENDTEXT"))
Chart1.Legends["Legend2"].CellColumns.Add(New LegendCellColumn("Sym", LegendCellColumnType.SeriesSymbol, ""))
Chart1.Legends["Legend2"].CellColumns.Add(New LegendCellColumn("Avg", LegendCellColumnType.Text, "#AVG{N2}"))
Chart1.Legends["Legend2"].CellColumns.Add(new LegendCellColumn("Name", LegendCellColumnType.Text, "#LEGENDTEXT"));
Chart1.Legends["Legend2"].CellColumns.Add(new LegendCellColumn("Sym", LegendCellColumnType.SeriesSymbol,""));
Chart1.Legends["Legend2"].CellColumns.Add(new LegendCellColumn("Avg", LegendCellColumnType.Text, "#AVG{N2}"));
LegendCellColumn 개체의 속성(예: MinimumWidth, MaximumWidth, Alignmnent, Margins, HeaderText, ItemColumnsSeparator)을 사용하여 각 열의 모양과 느낌을 조정할 수 있습니다.