Class RadialBarSeries

The RadialBarSeries displays data in different categories. Its typically used to make comparisons among a set of given data using the circular shapes of the bars.

Inheritance

System.Object

ChartSeries

CircularSeries

RadialBarSeries

Inherited Members

ChartSeries.CreateAnimation(Action<Double>)

ChartSeries.DrawSeries(ICanvas, ReadOnlyObservableCollection<ChartSegment>, RectF)

ChartSeries.EnableAnimation

ChartSeries.EnableAnimationProperty

ChartSeries.EnableTooltip

ChartSeries.EnableTooltipProperty

ChartSeries.Fill

ChartSeries.FillProperty

ChartSeries.GetDataPointIndex(Single, Single)

ChartSeries.IsVisible

ChartSeries.IsVisibleOnLegend

ChartSeries.IsVisibleOnLegendProperty

ChartSeries.IsVisibleProperty

ChartSeries.ItemsSource

ChartSeries.ItemsSourceProperty

ChartSeries.LabelContext

ChartSeries.LabelContextProperty

ChartSeries.LabelTemplate

ChartSeries.LabelTemplateProperty

ChartSeries.LegendIcon

ChartSeries.LegendIconProperty

ChartSeries.Opacity

ChartSeries.OpacityProperty

ChartSeries.PaletteBrushes

ChartSeries.PaletteBrushesProperty

ChartSeries.SelectionBehavior

ChartSeries.SelectionBehaviorProperty

ChartSeries.ShowDataLabels

ChartSeries.ShowDataLabelsProperty

ChartSeries.TooltipTemplate

ChartSeries.TooltipTemplateProperty

ChartSeries.XBindingPath

ChartSeries.XBindingPathProperty

ChartSeries.XRange

ChartSeries.YRange

CircularSeries.DataLabelSettings

CircularSeries.DataLabelSettingsProperty

CircularSeries.DrawDataLabel(ICanvas, Brush, String, PointF, Int32)

CircularSeries.EndAngle

CircularSeries.EndAngleProperty

CircularSeries.Radius

CircularSeries.RadiusProperty

CircularSeries.StartAngle

CircularSeries.StartAngleProperty

CircularSeries.Stroke

CircularSeries.StrokeProperty

CircularSeries.StrokeWidth

CircularSeries.StrokeWidthProperty

CircularSeries.YBindingPath

CircularSeries.YBindingPathProperty

Namespace: Syncfusion.Maui.Toolkit.Charts

Assembly: Syncfusion.Maui.Toolkit.dll

Syntax

public class RadialBarSeries : CircularSeries, IDatapointSelectionDependent, ITooltipDependent, IDataTemplateDependent, IDrawCustomLegendIcon

Remarks

It is similar to the DoughnutSeries. To render a series, create an instance of the RadialBarSeries class, and add it to the Series collection.

It provides options for TrackFill, TrackStroke, TrackStrokeWidth, MaximumValue, GapRatio, CapStyle, CenterView, PaletteBrushes, Fill, Stroke, StrokeWidth, and InnerRadius to customize the appearance.

Examples

    <chart:SfCircularChart>

          <chart:SfCircularChart.Series>
              <chart:RadialBarSeries
                  ItemsSource="{Binding Data}"
                  XBindingPath="XValue"
                  YBindingPath="YValue"
                  TrackFill="Red"
                  TrackStroke="Green"
                  TrackStrokeWidth="1"/>
          </chart:SfCircularChart.Series>

    </chart:SfCircularChart>

    SfCircularChart chart = new SfCircularChart();

    ViewModel viewModel = new ViewModel();

    RadialBarSeries series = new RadialBarSeries();
    series.ItemsSource = viewModel.Data;
    series.XBindingPath = "XValue";
    series.YBindingPath = "YValue";
    series.TrackFill = Brush.Red;
    series.TrackStroke = Brush.Green;
    series.TrackStrokeWidth = 1;
    chart.Series.Add(series);

    public ObservableCollection<Model> Data { get; set; }

    public ViewModel()
    {
       Data = new ObservableCollection<Model>();
       Data.Add(new Model() { XValue = 10, YValue = 100 });
       Data.Add(new Model() { XValue = 20, YValue = 150 });
       Data.Add(new Model() { XValue = 30, YValue = 110 });
       Data.Add(new Model() { XValue = 40, YValue = 230 });
    }

Constructors

RadialBarSeries()

Initializes a new instance of the RadialBarSeries class.

Declaration

public RadialBarSeries()

Fields

CapStyleProperty

Identifies the CapStyle bindable property.

Declaration

public static readonly BindableProperty CapStyleProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

Remarks

The CapStyle property represents the shape of the start and end points of a radial segment.

CenterViewProperty

Identifies the CenterView bindable property.

Declaration

public static readonly BindableProperty CenterViewProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

Remarks

The CenterView property indicates the view that added to the center of the radial bar.

GapRatioProperty

Identifies the GapRatio bindable property.

Declaration

public static readonly BindableProperty GapRatioProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

Remarks

The GapRatio property indicates the distance between two individual segments.

InnerRadiusProperty

Identifies the InnerRadius bindable property.

Declaration

public static readonly BindableProperty InnerRadiusProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

Remarks

The InnerRadius property determines the size of the inner circle.

MaximumValueProperty

Identifies the MaximumValue bindable property.

Declaration

public static readonly BindableProperty MaximumValueProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

Remarks

The MaximumValue property represents maximum value for the radial bar segments.

TrackFillProperty

Identifies the TrackFill bindable property.

Declaration

public static readonly BindableProperty TrackFillProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

Remarks

The TrackFill property specifies fill color of the track in a radial bar chart.

TrackStrokeProperty

Identifies the TrackStroke bindable property.

Declaration

public static readonly BindableProperty TrackStrokeProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

Remarks

The TrackStroke property defines the stroke color of the track in a radial bar chart.

TrackStrokeWidthProperty

Identifies the TrackStrokeWidth bindable property.

Declaration

public static readonly BindableProperty TrackStrokeWidthProperty

Field Value

Type
Microsoft.Maui.Controls.BindableProperty

Remarks

The TrackStrokeWidth property specifies the stroke thickness of the track in a radial bar chart.

Properties

CapStyle

Gets or sets the CapStyle value, that represents the shape of the start and end points of a radial segment.

Declaration

public CapStyle CapStyle { get; set; }

Property Value

Type	Description
CapStyle	It accepts CapStyle values, and its default is BothFlat

    <chart:SfCircularChart>

        <chart:SfCircularChart.BindingContext>
            <local:ViewModel/>
        </chart:SfCircularChart.BindingContext>

        <chart:RadialBarSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               CapStyle = "BothCurve"  />                       
    </chart:SfCircularChart>

    SfCircularChart chart = new SfCircularChart();

    ViewModel viewModel = new ViewModel();
    chart.BindingContext = viewModel;

    RadialBarSeries series = new RadialBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "XValue",
          YBindingPath = "YValue",
          CapStyle = CapStyle.BothCurve
    };

    chart.Series.Add(series);

CenterHoleSize

Gets the size of the radial bar center hole.

Declaration

public double CenterHoleSize { get; }

Property Value

Type
System.Double

CenterView

Gets or sets the view that added to the center of the radial bar.

Declaration

public View CenterView { get; set; }

Property Value

Type	Description
Microsoft.Maui.Controls.View	It accepts any Microsoft.Maui.Controls.View object, and its default value is null.

Examples

MainPage.xaml
C#

<chart:SfCircularChart>

        <chart:SfCircularChart.BindingContext>
            <local:ViewModel/>
        </chart:SfCircularChart.BindingContext>  

        <chart:SfCircularChart.Series>
            <chart:RadialBarSeries ItemsSource="{Binding Data}" 
                                   XBindingPath="XValue" 
                                   YBindingPath="YValue"/>
                 <chart:RadialBarSeries.CenterView>
                        <Label Text="CenterView"/>
                </chart:RadialBarSeries.CenterView>
        </chart:SfCircularChart.Series>

</chart:SfCircularChart>

 SfCircularChart chart = new SfCircularChart();

 ViewModel viewModel = new ViewModel();
 chart.BindingContext = viewModel;

 RadialBarSeries series = new RadialBarSeries()
 {
    ItemsSource = viewModel.Data,
    XBindingPath = "XValue",
    YBindingPath = "YValue",
 };

 Label label = new Label();
 label.Text = "CenterView"
 series.CenterView = label;
 chart.Series.Add(series);

GapRatio

Gets or sets the gap ratio, which indicates the distance between two individual segments.

Declaration

public double GapRatio { get; set; }

Property Value

Type	Description
System.Double	It accepts System.Double values, and its default value is `0.2`.

Remarks

The value ranges between 0 and 1.

Examples

Xaml
C#

    <chart:SfCircularChart>

        <chart:SfCircularChart.BindingContext>
            <local:ViewModel/>
        </chart:SfCircularChart.BindingContext>

        <chart:RadialBarSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               GapRatio = "0.3" />                       
    </chart:SfCircularChart>

    SfCircularChart chart = new SfCircularChart();

    ViewModel viewModel = new ViewModel();
    chart.BindingContext = viewModel;

    RadialBarSeries series = new RadialBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "XValue",
          YBindingPath = "YValue",
          GapRatio = 0.3
    };

    chart.Series.Add(series);

InnerRadius

Gets or sets a value that determines the size of the inner circle.

Declaration

public double InnerRadius { get; set; }

Property Value

Type	Description
System.Double	It accepts System.Double values, and the default value is 0.4.

Remarks

The value ranges between 0 and 1.

Examples

Xaml
C#

    <chart:SfCircularChart>

        <chart:SfCircularChart.BindingContext>
            <local:ViewModel/>
        </chart:SfCircularChart.BindingContext>

        <chart:RadialBarSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               InnerRadius = "0.2" />                       
    </chart:SfCircularChart>

    SfCircularChart chart = new SfCircularChart();

    ViewModel viewModel = new ViewModel();
    chart.BindingContext = viewModel;

    RadialBarSeries series = new RadialBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "XValue",
          YBindingPath = "YValue",
          InnerRadius = 0.2
    };

    chart.Series.Add(series);

MaximumValue

Gets or sets the maximum value for the radial bar segments.

Declaration

public double MaximumValue { get; set; }

Property Value

Type	Description
System.Double	It accepts System.Double values and its default value is System.Double.NaN

Examples

Xaml
C#

    <chart:SfCircularChart>

        <chart:SfCircularChart.BindingContext>
            <local:ViewModel/>
        </chart:SfCircularChart.BindingContext>

        <chart:RadialBarSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               MaximumValue="100"/>                       
    </chart:SfCircularChart>

    SfCircularChart chart = new SfCircularChart();

    ViewModel viewModel = new ViewModel();
    chart.BindingContext = viewModel;

    RadialBarSeries series = new RadialBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "XValue",
          YBindingPath = "YValue",
          MaximumValue = 100;
    };

    chart.Series.Add(series);

TrackFill

Gets or sets the brush value that represents the fill color of the track in a radial bar chart.

Declaration

public Brush TrackFill { get; set; }

Property Value

Type	Description
Microsoft.Maui.Controls.Brush	It accepts Microsoft.Maui.Controls.Brush values.

Examples

Xaml
C#

    <chart:SfCircularChart>

        <chart:SfCircularChart.BindingContext>
            <local:ViewModel/>
        </chart:SfCircularChart.BindingContext>

        <chart:RadialBarSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               TrackFill="Red"/>                       
    </chart:SfCircularChart>

    SfCircularChart chart = new SfCircularChart();

    ViewModel viewModel = new ViewModel();
    chart.BindingContext = viewModel;

    RadialBarSeries series = new RadialBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "XValue",
          YBindingPath = "YValue",
          TrackFill = Brush.Red
    };

    chart.Series.Add(series);

TrackStroke

Gets or sets the brush value that represents the stroke color of the track in a radial bar chart.

Declaration

public Brush TrackStroke { get; set; }

Property Value

Type	Description
Microsoft.Maui.Controls.Brush	It accepts Microsoft.Maui.Controls.Brush values.

Examples

Xaml
C#

    <chart:SfCircularChart>

        <chart:SfCircularChart.BindingContext>
            <local:ViewModel/>
        </chart:SfCircularChart.BindingContext>

        <chart:RadialBarSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               TrackStroke="Red"
                               TrackStrokeWidth="1"/>                       
    </chart:SfCircularChart>

    SfCircularChart chart = new SfCircularChart();

    ViewModel viewModel = new ViewModel();
    chart.BindingContext = viewModel;

    RadialBarSeries series = new RadialBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "XValue",
          YBindingPath = "YValue",
          TrackStroke = Brush.Red,
          TrackStrokeWidth = 1
    };

    chart.Series.Add(series);

TrackStrokeWidth

Gets or sets the value that represents the stroke thickness of the track in a radial bar chart.

Declaration

public double TrackStrokeWidth { get; set; }

Property Value

Type	Description
System.Double	It accepts System.Double values and its default value is 1.

Remarks

The value needs to be greater than zero.

Examples

Xaml
C#

    <chart:SfCircularChart>

        <chart:SfCircularChart.BindingContext>
            <local:ViewModel/>
        </chart:SfCircularChart.BindingContext>

        <chart:RadialBarSeries ItemsSource="{Binding Data}"
                               XBindingPath="XValue"
                               YBindingPath="YValue"
                               TrackStroke="Red"
                               TrackStrokeWidth="2"/>                       
    </chart:SfCircularChart>

    SfCircularChart chart = new SfCircularChart();

    ViewModel viewModel = new ViewModel();
    chart.BindingContext = viewModel;

    RadialBarSeries series = new RadialBarSeries()
    {
          ItemsSource = viewModel.Data,
          XBindingPath = "XValue",
          YBindingPath = "YValue",
          TrackStroke = Brush.Red,
          TrackStrokeWidth = 2
    };

    chart.Series.Add(series);

Methods

CreateSegment()

Creates and initializes a new chart segment for the chart.

Declaration

protected override ChartSegment CreateSegment()

Returns

Type
ChartSegment

Overrides

ChartSeries.CreateSegment()