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


Bar3DChart Class
Encapsulates the 3D version of a BarChart in a Worksheet.
Syntax
'Declaration
 
Public Class Bar3DChart 
   Inherits Column3DChart
 
'Usage
 
Dim instance As Bar3DChart
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 Bar3DChart with the generic Add method and set its SubType. The size of the Chart will be from Cell E4 to L18.
var bar3DChart = worksheet.Charts.Add<Bar3DChart>( "E4", "L18" );
bar3DChart.SubType = Bar3DChartSubType.Clustered;

// Sets the Chart's Title.
bar3DChart.Title.Text = "Profits";
bar3DChart.Title.TextOptions.Font.Bold = true;

// Sets the Legend.
bar3DChart.Legend.Position = LegendPositionType.Right;

// Sets the Category data(y values) for the Bar3DChart : Cells B4 to B8.
bar3DChart.CategoryData = CategoryData.FromCells( worksheet, "B4", "B8" );

// Adds BarSeries to the Bar3DChart (x values) by specifying fixed values, a Range of Cells’ Adresses and a Range of Cells’ Row & Column ids.
var barSeries1 = bar3DChart.SeriesCollection.AddFromValues<BarSeries>( 5, 10, 15, 20, 40 );
barSeries1.Name = "IBM";
var barSeries2 = bar3DChart.SeriesCollection.AddFromCells<BarSeries>( "C4", "C8" );
barSeries2.Name = "Apple";
var barSeries3 = bar3DChart.SeriesCollection.AddFromCells<BarSeries>( 3, 3, 7, 3 );
barSeries3.Name = "Amazon";

// 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.Chart3D
                  Xceed.Workbooks.NET.Column3DChart
                     Xceed.Workbooks.NET.Bar3DChart

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