BubbleSeriesView.MinSize Property

Gets or sets the minimum size of the marker of the Bubble series view.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v18.2.dll

Declaration

C#

[XtraSerializableProperty]
[XtraChartsLocalizableCategory(XtraChartsCategory.Layout)]
public double MinSize { get; set; }

VB.NET

<XtraSerializableProperty>
<XtraChartsLocalizableCategory(XtraChartsCategory.Layout)>
Public Property MinSize As Double

Property Value

Type	Description
Double	A Double value which specifies the marker’s minimum size (measured in X-axis units). The BubbleSeriesView.MaxSize and MinSize properties specify the marker’s size range on the X-axis.

Remarks

Bubble sizes are calculated automatically by default. Set the BubbleSeriesView.AutoSize property to false to manually specify maximum and minimum bubble sizes using the BubbleSeriesView.MaxSize and MinSize properties.

The MinSize property is intended to forcibly limit the minimum size of the marker when the weight of a series point is too low relative to the other series points, and this may affect the appearance of a chart.

When calculating a bubble’s size, the extreme values within a single series are taken into account. This means that the maximum value in a series determines the BubbleSeriesView.MaxSize of a bubble and the minimum value - its MinSize. These values are calculated in the measurement units of the X-axis.

Note that the MinSize property’s value should be less than the value of the BubbleSeriesView.MaxSize property.

Example

The following example demonstrates how to create a ChartControl with two series of the BubbleSeriesView type, and add this chart to a form at runtime. Before proceeding with this example, create a Windows Forms Application in Visual Studio, and add all required assemblies to the References list of your project.

Then, add the following code to the Form.Load event handler.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-create-a-bubble-chart-e904

Form1.cs

using System;
using System.Windows.Forms;
using DevExpress.XtraCharts;
// ...

namespace Series_BubbleChart {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e) {
            // Create a new chart.
            ChartControl bubbleChart = new ChartControl();

            // Create two bubble series.
            Series series1 = new Series("Series 1", ViewType.Bubble);
            Series series2 = new Series("Series 2", ViewType.Bubble);

            // Add points to them.
            series1.Points.Add(new SeriesPoint(1, 11, 2));
            series1.Points.Add(new SeriesPoint(2, 10, 1));
            series1.Points.Add(new SeriesPoint(3, 14, 3));
            series1.Points.Add(new SeriesPoint(4, 17, 2));

            series2.Points.Add(new SeriesPoint(1, 15, 3));
            series2.Points.Add(new SeriesPoint(2, 18, 4));
            series2.Points.Add(new SeriesPoint(3, 25, 2));
            series2.Points.Add(new SeriesPoint(4, 33, 1));

            // Add both series to the chart.
            bubbleChart.Series.AddRange(new Series[] { series1, series2 });

            // Set the numerical argument scale types for the series,
            // as it is qualitative, by default.
            series1.ArgumentScaleType = ScaleType.Numerical;
            series2.ArgumentScaleType = ScaleType.Numerical;

            // Access the view-type-specific options of the series.
            ((BubbleSeriesView)series1.View).AutoSize = false;
            ((BubbleSeriesView)series1.View).MaxSize = 1;
            ((BubbleSeriesView)series1.View).MinSize = 0.3;
            ((BubbleSeriesView)series1.View).BubbleMarkerOptions.Kind = MarkerKind.Circle;

            // Access the type-specific options of the diagram.
            ((XYDiagram)bubbleChart.Diagram).Rotated = true;

            // Hide the legend (if necessary).
            bubbleChart.Legend.Visibility = DevExpress.Utils.DefaultBoolean.False;

            // Add a chart to the form.
            bubbleChart.Dock = DockStyle.Fill;
            this.Controls.Add(bubbleChart);
        }
    }
}

Form1.vb

Imports System
Imports System.Windows.Forms
Imports DevExpress.XtraCharts
' ...

Namespace Series_BubbleChart
    Partial Public Class Form1
        Inherits Form

        Public Sub New()
            InitializeComponent()
        End Sub

        Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
            ' Create a new chart.
            Dim bubbleChart As New ChartControl()

            ' Create two bubble series.
            Dim series1 As New Series("Series 1", ViewType.Bubble)
            Dim series2 As New Series("Series 2", ViewType.Bubble)

            ' Add points to them.
            series1.Points.Add(New SeriesPoint(1, 11, 2))
            series1.Points.Add(New SeriesPoint(2, 10, 1))
            series1.Points.Add(New SeriesPoint(3, 14, 3))
            series1.Points.Add(New SeriesPoint(4, 17, 2))

            series2.Points.Add(New SeriesPoint(1, 15, 3))
            series2.Points.Add(New SeriesPoint(2, 18, 4))
            series2.Points.Add(New SeriesPoint(3, 25, 2))
            series2.Points.Add(New SeriesPoint(4, 33, 1))

            ' Add both series to the chart.
            bubbleChart.Series.AddRange(New Series() { series1, series2 })

            ' Set the numerical argument scale types for the series,
            ' as it is qualitative, by default.
            series1.ArgumentScaleType = ScaleType.Numerical
            series2.ArgumentScaleType = ScaleType.Numerical

            ' Access the view-type-specific options of the series.
            CType(series1.View, BubbleSeriesView).AutoSize = False
            CType(series1.View, BubbleSeriesView).MaxSize = 1
            CType(series1.View, BubbleSeriesView).MinSize = 0.3
            CType(series1.View, BubbleSeriesView).BubbleMarkerOptions.Kind = MarkerKind.Circle

            ' Access the type-specific options of the diagram.
            CType(bubbleChart.Diagram, XYDiagram).Rotated = True

            ' Hide the legend (if necessary).
            bubbleChart.Legend.Visibility = DevExpress.Utils.DefaultBoolean.False

            ' Add a chart to the form.
            bubbleChart.Dock = DockStyle.Fill
            Me.Controls.Add(bubbleChart)
        End Sub
    End Class
End Namespace

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the MinSize property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

VB.NET

how-to-keep-proportional-size-for-bubbles-corresponding-to-different-series-t180335/VB/WindowsApplication12/Form1.vb#L63

Dim valueDelta As Double = maxValue - minValue
Dim minSize As Double = infos.Min(Function(s) s.View.MinSize)
Dim maxSize As Double = infos.Max(Function(s) s.View.MaxSize)