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


In This Topic
    Surface3DChart Class
    In This Topic
    Encapsulates a Chart of the Surface3D type in a Worksheet.
    Syntax
    'Declaration
     
    
    Public Class Surface3DChart 
       Inherits Chart3D
    'Usage
     
    
    Dim instance As Surface3DChart
    public class Surface3DChart : Chart3D 
    Remarks
    A minimum of 2 SurfaceSeries is necessary in order to use this type of 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 Surface3DChart with the generic Add method and set its SubType. The size of the Chart will be from Cell E4 to L18.
    var surface3DChart = worksheet.Charts.Add<Surface3DChart>( "E4", "L18" );
    surface3DChart.SubType = Surface3DChartSubType.Surface;
    
    // Sets the Chart's Title.
    surface3DChart.Title.Text = "Profits";
    surface3DChart.Title.TextOptions.Font.Bold = true;
    
    // Sets the Legend.
    surface3DChart.Legend.Position = LegendPositionType.Right;
    
    // Sets the Category data(x values) for the Surface3DChart : Cells B4 to B8.
    surface3DChart.CategoryData = CategoryData.FromCells( worksheet, "B4", "B8" );
    
    // Adds SurfaceSeries to the Surface3DChart (y values) by specifying fixed values and a Range of Cells’ Adresses.
    var surfaceSeries1 = surface3DChart.SeriesCollection.AddFromValues<SurfaceSeries>( 5, 10, 15, 20, 40 );
    var surfaceSeries2 = surface3DChart.SeriesCollection.AddFromCells<SurfaceSeries>( "C4", "C8" );
    
    // 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.Surface3DChart

    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