BubbleSeriesView.BubbleMarkerOptions Property

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

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v20.1.dll

Declaration

[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.

Examples

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.

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