Gocpp: Load a Web Image from a URL into an Excel Worksheet with Go via C++

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

Load an Image from a URL into an Excel Worksheet

Aspose.Cells for C++ API provides a straightforward method to load images from URLs into Excel worksheets. This article explains how to download image data into a memory stream and insert it into the worksheet using Aspose.Cells. The image becomes embedded in the Excel file and doesn’t require external downloads when opened.

Sample Code

For scenarios requiring always‑updated images from a URL, use the method described in Insert a Linked Picture from Web Address. This approach loads the image from the URL each time the worksheet is opened.

Gocpp: Inserting an Image into a Cell

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

Aspose.Cells provides two distinct ways to associate an image with a single cell. A floating picture is a shape on the worksheet drawing layer that visually overlays a cell range, while an embedded image is stored inside the cell itself and scales automatically to the cell’s display area. Choose the approach that best matches your layout requirements.

Introduction

Fitting a picture exactly to a single cell is a common requirement when designing spreadsheets that act as visual reports, product catalogs, employee directories, dashboards, or inventory lists. Rather than stretching an image across many cells or placing it loosely on a worksheet, you may want a clean, cell-bound image that stays aligned with the cell that owns it. Aspose.Cells supports this scenario in two complementary ways:

Approach 1 — Place a floating picture over a cell. Add a Picture to the worksheet, set its Placement to MoveAndSize, and adjust its anchor cells (UpperLeftRow, UpperLeftColumn, LowerRightRow, LowerRightColumn) so the picture covers exactly one cell.
Approach 2 — Embed an image directly in a cell. Assign image bytes to the cell’s EmbeddedImage property. The image automatically scales to fit the cell’s display area and travels with the cell. The rest of this article walks through both approaches, explains the relevant APIs, and shows how to use them in code.

Approach 1: Place a Picture Over a Cell

A floating picture is a Picture object that lives on the worksheet drawing layer. Although it is not part of any single cell, it is anchored to a cell range. The picture’s anchor cells — its upper-left and lower-right corners — determine its visual extent on the worksheet. By default, a freshly added picture spans several cells. To make a floating picture cover exactly one cell, you need to:

Add the picture using Worksheet.Pictures.Add(int row, int column, Vector<uint8_t> stream), which anchors the new picture to the given cell.
Set the four anchor properties so the picture’s bounding rectangle coincides with the target cell.
Set Picture.Placement to PlacementType.MoveAndSize so the picture moves and resizes with the underlying cell when the user changes the column width or row height.

Anchoring the Picture to a Single Cell

The picture’s anchor is defined by four zero-based index properties:

Picture.UpperLeftRow — the row index of the picture’s top edge.
Picture.UpperLeftColumn — the column index of the picture’s left edge.
Picture.LowerRightRow — the row index of the picture’s bottom edge. To make the picture’s bottom edge sit at the bottom of row r, set this to r + 1.
Picture.LowerRightColumn — the column index of the picture’s right edge. To make the picture’s right edge sit at the right of column c, set this to c + 1.

Row and column indices in Aspose.Cells are zero-based. Cell C6 has row index 5 and column index 2. Off-by-one errors on the lower-right anchor are the most common source of pictures that appear to overlap into an adjacent cell.

Controlling Placement Behavior

Picture.Placement is an enum of type PlacementType that controls how the picture behaves when the user resizes the row or column beneath it. The recommended value for a single-cell picture is PlacementType.MoveAndSize, which causes the picture to move and resize together with its underlying cell, preserving the exact fit.

Step-by-Step Instructions

Create a new Workbook (or open an existing one).
Access the target Worksheet from workbook.GetWorksheets().Get(0].
Read the image file from disk into a Vector<uint8_t> byte buffer so the image bytes are available to the API.
Call worksheet.Pictures.Add(5, 2, imageData) to add a picture anchored to cell C6. Capture the returned Picture reference.
Set the four anchor coordinates so the picture covers only cell C6: UpperLeftRow = 5, UpperLeftColumn = 2, LowerRightRow = 6, LowerRightColumn = 3.
Set picture.Placement = PlacementType.MoveAndSize to keep the picture aligned with C6 when the column or row is resized.
Optionally add sample text to surrounding cells to demonstrate that only cell C6 contains the picture.
Save the workbook to disk as an .xlsx file. The following code demonstrates the complete approach.

Approach 2: Embed an Image Directly in a Cell

Aspose.Cells also exposes a simpler mechanism for cell-bound images: the Cell.EmbeddedImage property. Assigning image bytes to this property attaches the image to the cell itself, as if it were inline content.

How Embedded Images Work

The image is stored as part of the cell content rather than as a shape on the drawing layer.
The image automatically scales to fit inside the cell’s rendered boundaries. No anchor coordinates or placement settings are required.
The cell remains a real cell with a real address that can be referenced by formulas, sorted as part of a row, or used in other cell-level operations. This makes Cell.EmbeddedImage the most concise option when your goal is simply “an image that lives inside this cell.”

Step-by-Step Instructions

Create a new Workbook (or open an existing one).
Access the target Worksheet from workbook.GetWorksheets().Get(0].
Read the image file from disk into a Vector<uint8_t> byte array.
Get a reference to the target cell — either through worksheet.GetCells().Get("C6"] or worksheet.GetCells().Get(5, 2].
Assign the byte array to the cell’s EmbeddedImage property.
Optionally adjust the row height and column width of the target row and column to give the embedded image a more prominent appearance.
Save the workbook to disk as an .xlsx file. The following code demonstrates the complete approach.

Choosing the Right Approach

Both approaches produce a picture that fits inside a single cell, but they differ in how the picture is stored and how it behaves:

Use a floating picture (Approach 1) when:
- You need finer control over placement, layering, or alignment with other drawing objects.
- You want the picture to behave as a shape that can be selected, reordered, or grouped with other shapes.
- You require legacy compatibility with code that already works with PictureCollection.
- You need to compute anchor coordinates dynamically based on worksheet layout.
Use an embedded image (Approach 2) when:
- You want the simplest possible insertion of an image into a cell.
- The image should travel with the cell like any other cell content.

Gocpp: Insert a Picture Based on Cell Reference with Golang via C++

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

Sometimes you have an empty picture and need to display data or content in the picture by setting a cell reference in the Formula Bar. Aspose.Cells supports this feature (Microsoft Excel 2010).

Inserting a Picture Based on Cell Reference

Aspose.Cells supports displaying the contents of a worksheet cell in an image shape. You can link the picture to the cell that contains the data you want to display. Since the cell or cell range is linked to the graphic object, changes that you make to the data in that cell or cell range automatically appear in the graphic object. Add a picture to the worksheet by calling the AddPicture method of the ShapeCollection collection (encapsulated in the Worksheet object). Specify the cell range by using the Formula attribute of the Picture object.

Code Example

Gocpp: Add Conditional Icon Set with Cell Text using Golang via C++

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

Sometimes you want to add conditional icons next to the text in a cell to make data more meaningful to readers. You may want to use some of the conditional formatting icon types without applying conditional formatting to the cells. Aspose.Cells supports this feature.

The following code sample shows how to add a conditional icon set with the cell text.

Gocpp: Insert a Linked Picture from Web Address with Golang via C++

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

Sometimes you need to insert a picture from the web (http://) into a worksheet. To do so, specify the picture’s URL, and the picture will be downloaded each time the spreadsheet is opened in Microsoft Excel. The image is not physically embedded in the Excel document, but points to a web resource.

Using Microsoft Excel

In Microsoft Excel (for example, 2007):

Click the Insert menu and select Picture.
Specify the web address for the picture in the Insert Picture dialog.

Using Aspose.Cells for C++

Aspose.Cells for C++ supports adding a linked image using the ShapeCollection::AddLinkedPicture(int upperLeftRow, int upperLeftColumn, int heightPixels, int widthPixels, System::String sourceFullName) method. The method returns a Picture object.

The following example shows how to add a linked picture from a web address to a worksheet.

Documentation – Managing Pictures with Golang via C++

Gocpp: Load a Web Image from a URL into an Excel Worksheet with Go via C++

Load an Image from a URL into an Excel Worksheet

Sample Code

Gocpp: Inserting an Image into a Cell

Introduction

Approach 1: Place a Picture Over a Cell

Anchoring the Picture to a Single Cell

Controlling Placement Behavior

Step-by-Step Instructions

Approach 2: Embed an Image Directly in a Cell

How Embedded Images Work

Step-by-Step Instructions

Choosing the Right Approach

Related Articles

Gocpp: Insert a Picture Based on Cell Reference with Golang via C++

Inserting a Picture Based on Cell Reference

Code Example

Gocpp: Add Conditional Icon Set with Cell Text using Golang via C++

Gocpp: Insert a Linked Picture from Web Address with Golang via C++

Using Microsoft Excel

Using Aspose.Cells for C++