New to Telerik UI for WinForms? Start a free 30-day trial

BarSeries

Class

Represents a bar chart series that visualizes data points as rectangular bars where the height represents the magnitude of each value.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.ChartView.dll

Syntax:

public class BarSeries : CartesianSeries, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, IStylableElement, IStylableNode, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IShapedElement, IChartSeries, IChartElementPresenter, IAxisProvider

Inheritance: objectDisposableObjectRadObjectUIChartElementChartSeriesCartesianSeriesBarSeries...

Implements: IAxisProviderIBorderElementIBoxElementIBoxStyleIChartElementPresenterIChartSeriesICustomTypeDescriptorIDisposableIFillElementINotifyPropertyChangedIShapedElementIStylableElementIStylableNode...

Constructors

BarSeries()

Initializes a new instance of the BarSeries class.

public BarSeries()

BarSeries(string, string)

Initializes a new instance of the BarSeries class with the specified value and category members.

public BarSeries(string valueMember, string categoryMember)

Parameters:valueMemberstring

The name of the property that contains the data values for the bars.

categoryMemberstring

The name of the property that contains the category values for the bars.

BarSeries(string)

Initializes a new instance of the BarSeries class with the specified value member.

public BarSeries(string valueMember)

Parameters:valueMemberstring

The name of the property that contains the data values for the bars.

Fields

LabelModeProperty

RadProperty

Identifies the LabelMode dependency property.

public static readonly RadProperty LabelModeProperty

Properties

LabelMode

BarLabelModes

Gets or sets the positioning mode for bar labels.

public BarLabelModes LabelMode { get; set; }

Model

ChartSeriesModel

Gets the data model that represents the bar series structure and behavior.

public override ChartSeriesModel Model { get; }

Overrides: ChartSeries.Model

Methods

CreateModel()

Creates the data model for the bar series and initializes the data point collection.

protected override ChartDataPointCollection CreateModel()

Returns:

ChartDataPointCollection

A ChartDataPointCollection containing the bar data points.

Overrides: ChartSeries.CreateModel()

CreatePointElement(DataPoint)

Creates a visual element for the specified bar data point.

protected override DataPointElement CreatePointElement(DataPoint point)

Parameters:pointDataPoint

The data point for which to create the visual element.

Returns:

DataPointElement

A DataPointElement representing the bar.

Overrides: ChartSeries.CreatePointElement(DataPoint)

GetDefaultTrackballTextForPoint(DataPoint)

Gets the default trackball text for the specified data point.

protected override string GetDefaultTrackballTextForPoint(DataPoint point)

Parameters:pointDataPoint

The data point for which to generate trackball text.

Returns:

string

A string containing the formatted trackball text.

Overrides: ChartSeries.GetDefaultTrackballTextForPoint(DataPoint)

OnApplyPalette()

Applies the current palette to all bar point elements, setting their background and border colors.

protected override void OnApplyPalette()

Overrides: ChartSeries.OnApplyPalette()

ValidatePoint(DataPoint)

Validates that the specified data point is compatible with this bar series.

protected override void ValidatePoint(DataPoint item)

Parameters:itemDataPoint

The data point to validate.

Overrides: ChartSeries.ValidatePoint(DataPoint)