This topic provides information on how to configure UltraItemLegend control and explains, with code examples, how to use it with Chart Series in the UltraDataChart™ control.
The topic is organized as follows:
The Item Legend control identifies data items bound to BubbleSeries with their visual representation in the chart plot area. Legend’s visuals consist of a list of legend items that have legend badge representing a color of series as well as legend text that matches LabelMemberPath property of data item.
The Item Legend control shares common properties with other type of chart legends. Refer to the Chart Legends topic for a complete list of these common properties.
The UltraItemLegend control supports only BubbleSeries and it displays legend item for each data member bound to the series. The following table lists all requirements for this legend.
This code snippet demonstrates how to bind ItemLegend to BubbleSeries with LabelMemberPath mapped to a Label data column. (Figure 3)
Figure 1: Item Legend bound to BubbleSeries with LabelMemberPath mapped to a Label data column
In C#:
var itemLegend = new UltraItemLegend;
var series = new BubbleSeries();
series.LabelMemberPath = "Label";
series.Legend = itemLegend;
var DataChart = new UltraDataChart();
dataChart.Series.Add(series);In Visual Basic:
Dim itemLegend As New UltraItemLegend
Dim series As New BubbleSeries()
series.LabelMemberPath = "Label"
series.Legend = itemLegend
Dim dataChart As New UltraDataChart()
dataChart.Series.Add(series)