Documentation – Sparklines in Aspose.Cells for Go via C++

Gocpp: Using Sparklines and Settings 3D Format with Golang via C++

Mon, 01 Jan 0001 00:00:00 +0000

Using Sparklines

Microsoft Excel 2010 can analyze information in more ways than ever before. It allows users to track and highlight important data trends with new data analysis and visualization tools. Sparklines are mini‑charts that you can place inside cells so that you can view data and a chart on the same table. When sparklines are used properly, data analysis is quicker and more to the point. They also provide a simple view of information, avoiding overcrowded worksheets with a lot of busy charts.

Aspose.Cells provides an API for manipulating sparklines in spreadsheets.

Sparklines in Microsoft Excel

To insert sparklines in Microsoft Excel 2010:

Select the cells where you want the sparklines to appear. To make them easy to view, select cells at the side of the data.
Click Insert on the ribbon and then choose Column in the Sparklines group.
Select or enter the range of cells in the worksheet that contain the source data. The charts will appear.

Sparklines help you to see trends, for example, the win or loss record for a softball league. Sparklines can even sum up the entire season of each team in the league.

Sparklines using Aspose.Cells

Developers can create, delete, or read sparklines (in the template file) using the API provided by Aspose.Cells. The classes that manage sparklines are contained in the Aspose.Cells.Charts namespace, so you need to import this namespace before using these features.

By adding custom graphics for a given data range, developers have the freedom to add different types of tiny charts to selected cell areas.

The example below demonstrates the Sparklines feature. The example shows how to:

Open a simple template file.
Read sparklines information for a worksheet.
Add new sparklines for a given data range to a cell area.
Save the Excel file to disk.

Setting 3D Format

You might need 3D charting styles to obtain the results required for your scenario. Aspose.Cells provides the relevant API to apply Microsoft Excel 2007 3D formatting.

A complete example is given below to demonstrate how to create a chart and apply Microsoft Excel 2007 3D formatting. After executing the example code, a column chart (with 3D effects) will be added to the worksheet.

Gocpp: Convert Sparkline to Image and HTML in Aspose.Cells for Go via C++

Mon, 01 Jan 0001 00:00:00 +0000

Sparklines are miniature charts placed inside worksheet cells. Aspose.Cells lets you extract each sparkline as a standalone image (for embedding into another cell or an external report) and also export the entire sparkline-rich worksheet to HTML for browser-based distribution. The Cell.EmbeddedImage property used in this article is available in Aspose.Cells 26.5 and later.

Introduction

Sparklines are a compact way to visualize trends directly inside a worksheet. While Excel users see them in place, many real-world scenarios require a sparkline to leave the cell — for example, to be embedded into a different cell as a static picture, attached to an automated email, or rendered as part of an HTML report published to the web. Aspose.Cells supports both of these operations. The Sparkline.ToImage method renders an individual sparkline to a Vector<uint8_t> byte array, and the resulting bytes can be assigned to Cell.EmbeddedImage so the picture is stored inside a single cell of the workbook. Separately, HtmlSaveOptions lets you convert the entire workbook — sparklines and all — into a self-contained HTML file. This article walks through both workflows end to end.

Workflow 1 — Render Sparklines to Images and Embed Them into Cells

In this workflow you will build a worksheet that contains a small range of source values, attach three different sparkline groups (Line, Column, and Stacked/Win-Loss) to that range, render each group as a PNG, and write those PNG bytes into adjacent cells as embedded images. The final result is a single .xlsx file that contains both the live sparklines and their rendered picture counterparts.

Step-by-Step Instructions

Define a working directory and ensure it exists on disk.
Create a new Workbook and obtain a reference to the first Worksheet.
Populate cells A1 through E1 with five sample numeric values (for example, daily sales or temperature readings).
Add three SparklineGroup objects to the worksheet by calling worksheet.SparklineGroups.Add(...):
- A SparklineType.Line group anchored at F1, with data range A1:E1.
- A SparklineType.Column group anchored at G1, with data range A1:E1.
- A SparklineType.Stacked (win/loss) group anchored at H1, with data range A1:E1.
Build an ImageOrPrintOptions instance and set its ImageType to ImageType.Png so each sparkline is rendered as a transparent PNG.
Save the workbook as output_with_sparklines.xlsx.

The code above produces a workbook where each visual representation of a sparkline is duplicated in two forms: the live, native sparkline anchored at row 1, and a static PNG picture embedded directly into a neighboring cell on row 2. Because the pictures live inside the file itself, the workbook remains a single self-contained artifact that can be emailed or archived without breaking the embedded image references. Render each sparkline group as a PNG — Sparkline.ToImage(ImageOrPrintOptions) returns the picture bytes directly as a Vector<uint8_t> — and assign the array to the EmbeddedImage property of the target cell — the assignment is what makes the picture part of the cell’s stored contents.

Because each sparkline group is anchored to a single cell, you can address it through the indexer group.Sparklines[0] instead of enumerating with foreach. This keeps the rendering code short and matches the typical “one sparkline per anchor cell” pattern. Storing the picture bytes via Cell.EmbeddedImage requires Aspose.Cells 26.5 or later.

Workflow 2 — Export the Sparkline Worksheet to HTML

Once the workbook contains live sparklines (and optionally embedded picture counterparts), the entire worksheet can be published to the web by saving it as HTML. The HtmlSaveOptions class exposes the knobs you need to control this export; in this workflow you will reuse the output_with_sparklines.xlsx file produced by Workflow 1 and convert it to a clean, single-page HTML document.

Step-by-Step Instructions

Ensure the output_with_sparklines.xlsx file produced by Workflow 1 is available on disk in your working directory.
Load that file into a new Workbook instance.
Instantiate HtmlSaveOptions and set its ExportActiveWorksheetOnly property to true so the resulting HTML file contains only the active worksheet rather than the entire workbook.
Call workbook.Save("sparklines.html", htmlOptions) to write the HTML output to disk.

The code above takes the sparkline-rich workbook from Workflow 1 and turns it into a portable HTML file. Sparklines are preserved as inline SVG or PNG renderings inside the generated HTML, depending on the export mode, so end users can view the trends in any modern browser without needing Excel installed. By setting ExportActiveWorksheetOnly to true, you avoid accidentally publishing hidden sheets or auxiliary data — only the worksheet currently visible to the user is exported.

The HtmlSaveOptions class offers additional properties for fine-tuning the output, such as ExportHiddenWorksheet, ExportImagesAsBase64, and Encoding. Adjust these as needed for your deployment target.

API Summary

The workflows above rely on a small set of Aspose.Cells APIs working together.

SparklineGroup and the collection accessor worksheet.SparklineGroups are used to declare the type (Line, Column, Stacked), the data range, and the anchor cell for each sparkline group. In this article each group is anchored to a single cell, so the group is reached through worksheet.SparklineGroups[i].
Sparkline and the indexer group.Sparklines[0] return the individual sparkline inside a group. Because every group in the example contains exactly one sparkline, no foreach loop is required.
Sparkline.ToImage(ImageOrPrintOptions) is the rendering method that returns a picture of the sparkline directly as a Vector<uint8_t> byte array.
HtmlSaveOptions.ExportActiveWorksheetOnly (a bool) restricts HTML export to the active worksheet. It is one of the most commonly used properties on HtmlSaveOptions when generating single-page reports.
ImageOrPrintOptions.ImageType lives in the Aspose.Cells.Drawing namespace and selects the picture format (for example, ImageType.Png) used when rendering with ToImage and when printing worksheets to images.

Inserting an Image into a Cell

Gocpp: Copy Sparkline by Specifying Data Range and Location of Sparkline Group with Golang via C++

Mon, 01 Jan 0001 00:00:00 +0000

Microsoft Excel allows you to copy a sparkline by specifying the data range and location of a sparkline group. Aspose.Cells supports this feature.

To copy a sparkline to other cells in Microsoft Excel:

Select the cell containing the sparkline.
Select Edit Data from the Sparkline section of the Design tab.
Select Edit Group Location & Data.
Specify the data range and location.
Click OK.

Aspose.Cells provides the SparklineCollection.Add(dataRange, row, column) method to specify a sparkline group’s data range and location. The following sample code loads the source Excel file (as shown in the screenshot above), accesses the first sparkline group, and adds data ranges and locations to the sparkline group. Finally, it writes the output Excel file to disk, which is also shown in the screenshot above.

Documentation – Sparklines in Aspose.Cells for Go via C++

Gocpp: Using Sparklines and Settings 3D Format with Golang via C++

Using Sparklines

Sparklines in Microsoft Excel

Sparklines using Aspose.Cells

Setting 3D Format

Gocpp: Convert Sparkline to Image and HTML in Aspose.Cells for Go via C++

Introduction

Workflow 1 — Render Sparklines to Images and Embed Them into Cells

Step-by-Step Instructions

Workflow 2 — Export the Sparkline Worksheet to HTML

Step-by-Step Instructions

API Summary

Related Articles

Gocpp: Copy Sparkline by Specifying Data Range and Location of Sparkline Group with Golang via C++