Add Image Hyperlinks

Hyperlinks are useful for accessing the information on other worksheets, or on websites. Microsoft Excel lets users add hyperlinks to the text in cells, and on images. Image hyperlinks can make navigating a worksheet easier, for example, as next and previous buttons, or logos that link to particular sites. This document explains how to insert image hyperlinks in a worksheet using Aspose.Cells.

Aspose.Cells allows you to add hyperlinks to images in spreadsheets at runtime. It is possible to set and modify the link’s screen tip and address.

The following sample code illustrates how to add an image hyperlink into a worksheet.

When the code runs, it saves an output file with an image hyperlink in it.

The output file

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
String dataDir = Utils.getDataDir(AddImageHyperlinks.class);

// Instantiate a new workbook
Workbook workbook = new Workbook();

// Get the first worksheet
Worksheet worksheet = workbook.getWorksheets().get(0);

// Insert a string value to a cell
worksheet.getCells().get("C2").setValue("Image Hyperlink");

// Set the 4th row height
worksheet.getCells().setRowHeight(3, 100);

// Set the C column width
worksheet.getCells().setColumnWidth(2, 21);

// Add a picture to the C4 cell
int index = worksheet.getPictures().add(3, 2, 4, 3, dataDir + "aspose-logo.jpg");

// Get the picture object
com.aspose.cells.Picture pic = worksheet.getPictures().get(index);

// Set the placement type
pic.setPlacement(PlacementType.FREE_FLOATING);

// Add an image hyperlink
pic.addHyperlink("http://www.aspose.com/");
com.aspose.cells.Hyperlink hlink = pic.getHyperlink();

// Specify the screen tip
hlink.setScreenTip("Click to go to Aspose site");

// Save the Excel file
workbook.save(dataDir + "ImageHyperlink.xls");