Edit this page

BarSeries

This series is visualized on the screen as separate rectangles representing each of the data points. The height (width) of the box is the distance between the point’s numerical value and the categorical axis that plots the point.

Declaratively defined series

You can use the definition from Example 1 to display a BarSeries.

[XAML] Example 1: Declaring a BarSeries in XAML

<telerik:RadCartesianChart Palette="Windows8">
<telerik:RadCartesianChart.HorizontalAxis>
    <telerik:CategoricalAxis/>
</telerik:RadCartesianChart.HorizontalAxis>
<telerik:RadCartesianChart.VerticalAxis>
    <telerik:LinearAxis />
</telerik:RadCartesianChart.VerticalAxis>
<telerik:RadCartesianChart.Series>
    <telerik:BarSeries>
        <telerik:BarSeries.DataPoints>
            <telerik:CategoricalDataPoint Category="January" Value="2" />
            <telerik:CategoricalDataPoint Category="February" Value="5" />
            <telerik:CategoricalDataPoint Category="March" Value="3" />
            <telerik:CategoricalDataPoint Category="April" Value="10" />
            <telerik:CategoricalDataPoint Category="May" Value="9" />
            <telerik:CategoricalDataPoint Category="June" Value="7" />
            <telerik:CategoricalDataPoint Category="July" Value="1" />
        </telerik:BarSeries.DataPoints>
    </telerik:BarSeries>
</telerik:RadCartesianChart.Series>
</telerik:RadCartesianChart>

Figure 1: BarSeries visual appearance

radchartview-series-barseries

Properties

  • CategoryBinding: A property of type DataPointBinding that gets or sets the property path that determines the category value of the data point.
  • ValueBinding: A property of type DataPointBinding that gets or sets the property path that determines the value of the data point.
  • OriginValue: A property of type double which controls the origin value from which the series should start drawing on the numeric axis (LinearAxis or LogarithmicAxis).
  • LegendSettings: A property of type ChartLegendSettings that gets or sets the legend setting.
  • PaletteMode: A property of type SeriesPaletteMode that gets or sets the mode that determines how the pallete should be applied. This property will be applied only if the Palette property of the chart is set. The pallete mode is an enumeration and it allows the following values:
    • Series: Default value. When set every series will be applied a different color.
    • DataPoint: When set each data point will have a different color.

Data Binding

You can use the ValueBinding and CategoryBinding properties of the BarSeries to bind the DataPoints’ properties to the properties from your view models.

[C#] Example 2: Defining the view model

public class PlotInfo
{
    public string Category { get; set; }
    public double Value { get; set; }
}

//.......
this.DataContext = new ObservableCollection<PlotInfo>
{
    new PlotInfo() { Category = "January", Value = 2},
    //....
};

[XAML] Example 3: Specify a BarSeries in XAML

<telerik:BarSeries ItemsSource="{Binding}" CategoryBinding="Category" ValueBinding="Value" />

See the Create Data-Bound Chart for more information on data binding in the RadChartView suite.

Features

The series supports all standard features exposed by all other categorical series. However, the specification of the series brings few additional functionalities which are listed below:

  • DataPointLegendSettings: The series supports two types of legend settings, the first one is the common SeriesLegendSettings which can be used with all types of series and it maps each legend item to a series. The series supports an additional DataPointLegendSettings which maps the legend items per data point.

[XAML] Example 4: Specify LegendSettings of the BarSeries

<telerik:BarSeries.LegendSettings>
    <telerik:DataPointLegendSettings/>
</telerik:BarSeries.LegendSettings>

Figure 2: Setting BarSeries legend settings

radchartview-series-barseries

  • PaletteMode: The BarSeries supports two modes that determine whether the applied palette should be applied per series or per data point. The mode can be controlled through the PalleteMode property. The modes are called Series and DataPoint. The following image demonstrates the DataPoint PaletteMode with the Windows8 palette applied:

Figure 3: Specify BarSeries pallete mode

radchartview-series-barseries

Setting the PaletteMode to Series will apply different color for each series defined in the chart.

  • Hover interactivity: RadCartesianChart exposes a property called HoverMode. This property can be used only by the bar and bubble series. If it is set to “FadeOtherSeries”, when you mouse over a data point, the bar from all other series will fade out. The default value of the property is “None”.

[XAML] Example 8: Setting the HoverMode of the RadCartesianChart

<telerik:RadCartesianChart HoverMode="FadeOtherSeries">

Figure 4: Hover interactivity in BarSeries

radchartview-series-barseries

Styling the Series

You can see how to style area series using different properties in the BarSeries section of the Customizing CartesianChart Series help article.

Additionally, you can use the Palette property of the chart to change the colors of the BarSeries on a global scale. You can find more information about this feature in the Palettes section in our help documentation.

See Also