BubbleSeriesView.BubbleMarkerOptions Property

Gets the specific settings of the data point markers displayed by a series of the Bubble view type.

Assembly : DevExpress.XtraCharts.v25.2.dll

Declaration

C#
VB.NET

csharp

[PersistenceMode(PersistenceMode.InnerProperty)]
[XtraChartsLocalizableCategory(XtraChartsCategory.Appearance)]
public MarkerBase BubbleMarkerOptions { get; }

<PersistenceMode(PersistenceMode.InnerProperty)>
<XtraChartsLocalizableCategory(XtraChartsCategory.Appearance)>
Public ReadOnly Property BubbleMarkerOptions As MarkerBase

Property Value

Type	Description
MarkerBase

A MarkerBase object that contains the specific marker settings.

Remarks

The BubbleMarkerOptions property provides access to the settings which define how the data point markers are displayed within a series of the Bubble type.

A characteristic feature of the Bubble series view, is that it’s marker bears a special function - to display a third dimension of data for the series point, expressed as the marker’s size. So, it is also possible to forcibly limit the minimum and maximum size of the marker by using the series’ BubbleSeriesView.MaxSize and BubbleSeriesView.MinSize properties.

Also note that, though the Bubble series view is called “bubble” because of it’s marker shape, other marker types can be defined for it, using the MarkerBase.Kind 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.

Form1.cs
Form1.vb

csharp

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);
        }
    }
}

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