Other API Samples

Live SpreadsheetGear API Samples

Charting Stock V-O-H-L-C Stock Chart

Demonstrates generating a V-O-H-L-C Stock Chart.

// Create a new workbook and get a reference to the active sheet and its cells.
SpreadsheetGear.IWorkbook workbook = 
SpreadsheetGear.IWorksheet worksheet = workbook.ActiveWorksheet;
SpreadsheetGear.IRange cells = worksheet.Cells;

// Get a reference to the worksheet window info and shapes collection.
SpreadsheetGear.IWorksheetWindowInfo windowInfo = worksheet.WindowInfo;
SpreadsheetGear.Shapes.IShapes shapes = worksheet.Shapes;

// Add a chart to the worksheet's shape collection.
// NOTE: Calculate the coordinates of the chart by converting row and column
//       coordinates to points.  Use fractional row and column values to get 
//       coordinates anywhere in between row and column boundaries.
double left = windowInfo.ColumnToPoints(0.15);
double top = windowInfo.RowToPoints(0.5);
double right = windowInfo.ColumnToPoints(5.85);
double bottom = windowInfo.RowToPoints(13.5);
SpreadsheetGear.Charts.IChart chart =
    shapes.AddChart(left, top, right - left, bottom - top).Chart;

// Get the source data range from an existing XML File.
SpreadsheetGear.IRange source = cells["G2:L24"];

// Set the chart's source data range, plotting series in columns.
chart.SetSourceData(source, SpreadsheetGear.Charts.RowCol.Columns);

// Set the chart type to a volume-open-high-low-close stock chart.
chart.ChartType = SpreadsheetGear.Charts.ChartType.StockVOHLC;

// Get a reference to the first chart group used for volume series.
SpreadsheetGear.Charts.IChartGroup volumeGroup = chart.ChartGroups[0];

// Increase the volume series bar width by decreasing the gap width.
volumeGroup.GapWidth = 75;

// Get a reference to the second chart group used for stock values.
SpreadsheetGear.Charts.IChartGroup stockGroup = chart.ChartGroups[1];

// Change the fill color of the down bars.
stockGroup.DownBars.Format.Fill.ForeColor.RGB = SpreadsheetGear.Colors.Red;

// Change the fill color of the up bars.
stockGroup.UpBars.Format.Fill.ForeColor.RGB = SpreadsheetGear.Colors.Green;

// Get a reference to the primary category axis.
SpreadsheetGear.Charts.IAxis categoryAxis =

// Change the primary category axis to always use a category scale.
categoryAxis.CategoryType =

// Set the label frequency of the primary category axis.
categoryAxis.TickLabelSpacing = 7;

// Get a reference to the primary value axis.
SpreadsheetGear.Charts.IAxis valueAxis =

// Set the min, max, and major units of the primary value axis.
valueAxis.MinimumScale = 0;
valueAxis.MaximumScale = 130000;
valueAxis.MajorUnit = 26000;

// Hide the major gridlines on the primary value axis.
valueAxis.HasMajorGridlines = false;

// Get a reference to the secondary value axis.
valueAxis = chart.Axes[

// Set the min, max, and major units of the secondary value axis.
valueAxis.MinimumScale = 0;
valueAxis.MaximumScale = 130;
valueAxis.MajorUnit = 26;

// Hide the major gridlines on the secondary value axis.
valueAxis.HasMajorGridlines = false;

// Delete the legend.
chart.HasLegend = false;

// Add a chart title and change the font size.
chart.HasTitle = true;
chart.ChartTitle.Text = "ABC Company (Volume-Open-High-Low-Close)";
chart.ChartTitle.Font.Size = 10;
Run This Sample
Render Image

Generate an image representation of the results of this sample, which uses the SpreadsheetGear.Drawing.Image class to convert ranges, charts and shapes to images.

Download File

Download an Excel Open XML Workbook (*.xlsx) file with the results of this sample.

Supporting Files

The following files are utilized by this sample: