BubbleSeriesView Class

Represents a series view of the Bubble type.

Assembly : DevExpress.XtraCharts.v25.2.dll

Declaration

C#
VB.NET

csharp

public class BubbleSeriesView :
    PointSeriesViewBase,
    IXYWSeriesView,
    IXYSeriesView,
    ISeriesView,
    ISupportTransparency

Public Class BubbleSeriesView
    Inherits PointSeriesViewBase
    Implements IXYWSeriesView,
               IXYSeriesView,
               ISeriesView,
               ISupportTransparency

Remarks

The BubbleSeriesView class provides the functionality of a series view of the Bubble type within a chart control.

In addition to the common view settings inherited from the base PointSeriesViewBase class, the BubbleSeriesView class declares specific point type settings which allow you to define the settings of point markers (BubbleSeriesView.BubbleMarkerOptions), the maximum and minimum allowed size of bubbles (BubbleSeriesView.MaxSize and BubbleSeriesView.MinSize) and the transparency of bubbles (BubbleSeriesView.Transparency).

Note that a particular view type can be defined for a series using its SeriesBase.View property.

For more information on the Bubble series view, please see the Bubble Chart topic.

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

Implements

IXtraSerializable

IXYSeriesView2D

IXtraSupportDeserializeCollectionItem

ISupportTransparency

Inheritance

Object ChartElement SeriesViewBase XYDiagram2DSeriesViewBase XYDiagramSeriesViewBase SeriesViewColorEachSupportBase PointSeriesViewBase BubbleSeriesView