DxPolarChartBarSeries<T, TArgument, TValue> Class
Defines a bar series.
Namespace: DevExpress.Blazor
Assembly: DevExpress.Blazor.v24.2.dll
NuGet Package: DevExpress.Blazor
#Declaration
public class DxPolarChartBarSeries<T, TArgument, TValue> :
DxPolarChartBaseSeries<T, TArgument, TValue>
#Type Parameters
Name | Description |
---|---|
T | The data type. |
TArgument | The series argument type. |
TValue | The series value type. |
#Remarks
The bar series displays data as a collection of bars.
#Declare a Bar Series
- Use the Polar Chart’s Data property to specify a data source.
- Add a
<DxPolarChartBarSeries>
tag to the component’s markup. - Assign data source fields that contain arguments and values for data points to ArgumentField and ValueField properties.
- Optional. Configure the series: customize appearance, add labels, choose selection and hover modes, etc.
<DxPolarChart Data=@DataSource>
<DxPolarChartBarSeries ArgumentField="@((DiscretePoint i) => i.Arg)"
ValueField="@((DiscretePoint i) => i.Day)">
</DxPolarChartBarSeries>
<DxChartLegend Visible="false" />
</DxPolarChart>
#Nested Component Structure
You can add the following child components to a bar series:
- DxChartSeriesLabel
- Defines a series label.
- DxChartSeriesLegendItem
- Defines an item that indicates a series in the legend.
- DxChartSeriesPoint
- Contains settings for points of the chart’s line- and area-based series.
Note that the Polar Chart treats individual bars as points. If you specify the same property at both series and series point levels, the latter has a higher priority.
The following code snippet declares these objects in the markup:
@using System.Drawing
<DxPolarChart Data=@DataSource>
<DxChartLegend Position="RelativePosition.Outside" />
<DxPolarChartBarSeries ArgumentField="@((DiscretePoint i) => i.Arg)"
ValueField="@((DiscretePoint i) => i.Day)"
Color="Color.Lavender">
<DxChartSeriesLegendItem Text="Daily Temperature" />
<DxChartSeriesLabel Visible="true" FormatPattern="{value:##.#}" />
<DxChartSeriesPoint Color="Color.Blue" />
</DxPolarChartBarSeries>
</DxPolarChart>
#Customize Appearance
The Polar Chart allows you to use the following options to customize a bar series:
- BarPadding
- Specifies the padding between bars in a bar group, as a percentage.
- BarWidth
- Specifies the width of an individual bar in the series, in pixels.
- BreakOnEmptyPoints
- Specifies whether the series should break on points with null values.
- Color
- Specifies the color of the series.
- MinBarHeight
- Specifies the minimum bar height, in pixels.
@using System.Drawing
<DxPolarChart Data=@DataSource>
<DxPolarChartBarSeries ArgumentField="@((DiscretePoint i) => i.Arg)"
ValueField="@((DiscretePoint i) => i.Day)"
BarPadding="0.4"
Color="Color.Lavender">
</DxPolarChartBarSeries>
</DxPolarChart>
#User Interaction Options
Users can select and hover the mouse pointer over a series and its elements. The table below describes available user interaction options. Since the Polar Chart component treats individual bars as points, the SeriesSelectionMode property is not applicable to a bar series.
Description | Component Level | Series Level |
---|---|---|
Hover Over Series and Its Elements | Not Applicable | Hover |
Point Selection | Point |
Selection |