.NET Framework 4.5.2+
.NET Framework 4.5.2+
.NET Standard 2.0+

SurfaceOptions Interface

Contains formatting options for a particular surface of a 3-D chart.

Namespace: DevExpress.Spreadsheet.Charts

Assembly: DevExpress.Spreadsheet.v21.2.Core.dll

Declaration

public interface SurfaceOptions :
    ShapeFormat,
    ShapeFormatBase

Remarks

The SurfaceOptions interface provides formatting options for the three-dimensional chart side wall, back wall and floor.

3DChartElements

An object exposing the SurfaceOptions interface can be accessed by using the View3DOptions.SideWall, View3DOptions.BackWall or View3DOptions.Floor property, depending on the surface you wish to format. The SurfaceOptions interface allows you to define the surface filling and border line settings (via the ShapeFormatBase.Fill and ShapeFormatBase.Outline properties inherited from the ShapeFormatBase interface) and specify the surface thickness (by utilizing the SurfaceOptions.Thickness property).

Example

The example below demonstrates how to create the 3-D clustered column chart and adjust its appearance. In particular, the code specifies how to customize the chart walls and floor by using the View3DOptions.BackWall, View3DOptions.SideWall and View3DOptions.Floor properties.

Worksheet worksheet = workbook.Worksheets["chartTask5"];
workbook.Worksheets.ActiveWorksheet = worksheet;

// Create a chart and specify its location.
Chart chart = worksheet.Charts.Add(ChartType.Column3DClustered, worksheet["B2:C8"]);
chart.TopLeftCell = worksheet.Cells["F2"];
chart.BottomRightCell = worksheet.Cells["L15"];

// Specify that each data point in the series has a different color.
chart.Views[0].VaryColors = true;
// Specify the series outline.
chart.Series[0].Outline.SetSolidFill(Color.AntiqueWhite);
// Hide the legend.
chart.Legend.Visible = false;

// Specify the side wall color.
chart.View3D.SideWall.Fill.SetSolidFill(Color.FromArgb(0xDC, 0xFA, 0xDD));
// Specify the pattern fill for the back wall.
chart.View3D.BackWall.Fill.SetPatternFill(Color.FromArgb(0x9C, 0xFB, 0x9F), Color.WhiteSmoke, DevExpress.Spreadsheet.Drawings.ShapeFillPatternType.DiagonalBrick);

SurfaceOptions floorOptions = chart.View3D.Floor;
// Specify the floor color.
floorOptions.Fill.SetSolidFill(Color.FromArgb(0xFA, 0xDC, 0xF9));
// Specify the floor border. 
floorOptions.Outline.SetSolidFill(Color.FromArgb(0xB4, 0x95, 0xDE));
floorOptions.Outline.Width = 1.25;

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SurfaceOptions interface.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

See Also