Xceed Workbooks for .NET v3.0 Documentation
Xceed.Workbooks.NET Assembly / Xceed.Workbooks.NET Namespace / BubbleChart Class
Members Example


In This Topic
    BubbleChart Class
    In This Topic
    Encapsulates a Chart of the Bubble type in a Worksheet
    Syntax
    'Declaration
     
    
    Public Class BubbleChart 
       Inherits Chart
    'Usage
     
    
    Dim instance As BubbleChart
    public class BubbleChart : Chart 
    Example

    The code below would display the following Chart:

     

    var workbook = Workbook.Create( ChartSample.ChartSampleOutputDirectory + @"AddCharts.xlsx" );
    
    // Gets the first Worksheet. A Workbook always contains at least 1 Worksheet.
    var worksheet = workbook.Worksheets[ 0 ];
    
    // Adds Values for Category.
    worksheet.Cells[ "B4" ].Value = 2020;
    worksheet.Cells[ "B5" ].Value = 2021;
    worksheet.Cells[ "B6" ].Value = 2022;
    worksheet.Cells[ "B7" ].Value = 2023;
    worksheet.Cells[ "B8" ].Value = 2024;
    
    // Adds Values for Series.
    worksheet.Cells[ "C4" ].Value = 20;
    worksheet.Cells[ "C5" ].Value = 28;
    worksheet.Cells[ "C6" ].Value = 33;
    worksheet.Cells[ "C7" ].Value = 12;
    worksheet.Cells[ "C8" ].Value = 45;
    worksheet.Cells[ "D4" ].Value = 7;
    worksheet.Cells[ "D5" ].Value = 33;
    worksheet.Cells[ "D6" ].Value = 15;
    worksheet.Cells[ "D7" ].Value = 35;
    worksheet.Cells[ "D8" ].Value = 25;
    
    // Adds a BubbleChart with the generic Add method and set its SubType. The size of the Chart will be from Cells E4 to L18.
    var bubbleChart = worksheet.Charts.Add<BubbleChart>( "E4", "L18" );
    bubbleChart.SubType = BubbleChartSubType.Bubble2D;
    
    // Sets the Chart's Title.
    bubbleChart.Title.Text = "Profits";
    bubbleChart.Title.TextOptions.Font.Bold = true;
    
    // Sets the Legend.
    bubbleChart.Legend.Position = LegendPositionType.Right;
    
    // Sets the Category data(x values) for the BubbleChart : Cells B4 to B8.
    bubbleChart.CategoryData = CategoryData.FromCells( worksheet, "B4", "B8" );
    
    // Adds BubbleSeries to the BubbleChart (y values) by specifying fixed values, a range of Cells' Adresses and a Range of Cells' Row & Column ids.
    var barSeries1 = bubbleChart.SeriesCollection.AddFromValues<BubbleSeries>( 5, 10, 15, 20, 40 );
    barSeries1.Name = "IBM";
    var barSeries2 = bubbleChart.SeriesCollection.AddFromCells<BubbleSeries>( "C4", "C8" );
    barSeries2.Name = "Apple";
    var barSeries3 = bubbleChart.SeriesCollection.AddFromCells<BubbleSeries>( 3, 3, 7, 3 );
    barSeries3.Name = "Amazon";
    
    // Scales all the bubble to 50% of their sizes.
    bubbleChart.BubbleScale = 50;
    
    // Saves Workbook to disk.
    workbook.Save();
    Inheritance Hierarchy

    System.Object
       Xceed.Workbooks.NET.WorkbookElement
          Xceed.Workbooks.NET.WorksheetElement
             Xceed.Workbooks.NET.PositionedElement
                Xceed.Workbooks.NET.Chart
                   Xceed.Workbooks.NET.BubbleChart

    Public Constructors
     NameDescription
    Public ConstructorCreates a BubbleChart in the Worksheet.  
    Top
    Public Properties
     NameDescription
    Public PropertyGets or sets the absolute Position of the PositionedElement. (Inherited from Xceed.Workbooks.NET.PositionedElement)
    Public PropertyGets or sets the position of the Anchor in the Worksheet. (Inherited from Xceed.Workbooks.NET.PositionedElement)
    Public PropertyGets the Anchor's type. (Inherited from Xceed.Workbooks.NET.PositionedElement)
    Public PropertyGets the Chart's Border. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets or sets the value used to offset the bottom right corner of a TwoCellAnchor PositionedElement. (Inherited from Xceed.Workbooks.NET.PositionedElement)
    Public PropertyGets or sets the scale for all the bubbles in the BubbleChart.  
    Public PropertyGets the Chart's CategoryAxis. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets or sets the CategoryData that will be used for the Chart's CategoryAxis. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets or sets the PositionedElement's description. (Inherited from Xceed.Workbooks.NET.PositionedElement)
    Public PropertyGets the DrawingClientData, which is how the data should behave when the Worksheet is protected. (Inherited from Xceed.Workbooks.NET.PositionedElement)
    Public PropertyGets the Chart's Fill. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets or sets the height of an AbsoluteAnchor or OneCellAnchor PositionedElement. (Inherited from Xceed.Workbooks.NET.PositionedElement)
    Public PropertyGets or sets if the Chart automatically varies Colors for its Series' data. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets or sets if the Chart has rounded corners. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets the Chart's Legend. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets or sets the Units used for measuring the PositionedElement's WidthHeight. (Inherited from Xceed.Workbooks.NET.PositionedElement)
    Public PropertyGets or sets the name of the PositionedElement. (Inherited from Xceed.Workbooks.NET.PositionedElement)
    Public PropertyGets the Chart's PlotArea. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets the Chart's secondary CategoryAxis. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets the Chart's secondary ValueAxis. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets the Chart's SeriesCollection. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets or sets if bubbles will be visible when their size is negative.  
    Public PropertyGets or sets the BubbleChart's sub type.  
    Public PropertyGets or sets the Chart's title. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets or sets the value used to offset the top right corner of a TwoCellAnchor PositionedElement. (Inherited from Xceed.Workbooks.NET.PositionedElement)
    Public PropertyGets or sets the behavior of a TwoCellAnchor PositionedElement when moving or deleting Rows or Columns.  (Inherited from Xceed.Workbooks.NET.PositionedElement)
    Public PropertyGets the Chart's ValueAxis. (Inherited from Xceed.Workbooks.NET.Chart)
    Public PropertyGets or sets the width of an AbsoluteAnchor or OneCellAnchor PositionedElement. (Inherited from Xceed.Workbooks.NET.PositionedElement)
    Top
    Requirements

    Target Platforms: Windows 11, Windows 10, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also