Add Image Hyperlinks

Hyperlinks are useful for accessing information on other worksheets, or on websites. Microsoft Excel lets users add hyperlinks on 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 for Python via .NET.

Aspose.Cells for Python via .NET 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.

from aspose.cells import Workbook
from aspose.cells.drawing import PlacementType
from os import os, path

#  For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
#  The path to the documents directory.
dataDir = RunExamples.GetDataDir(".")
#  Create directory if it is not already present.
IsExists = path.isdir(dataDir)
if notIsExists:
    os.makedirs(dataDir)
#  Instantiate a new workbook
workbook = Workbook()
#  Get the first worksheet
worksheet = workbook.worksheets[0]
#  Insert a string value to a cell
worksheet.cells.get("C2").put_value("Image Hyperlink")
#  Set the 4th row height
worksheet.cells.set_row_height(3, 100)
#  Set the C column width
worksheet.cells.set_column_width(2, 21)
#  Add a picture to the C4 cell
index = worksheet.pictures.add(3, 2, 4, 3, dataDir + "aspose-logo.jpg")
#  Get the picture object
pic = worksheet.pictures[index]
#  Set the placement type
pic.placement = PlacementType.FREE_FLOATING
#  Add an image hyperlink
hlink = pic.add_hyperlink("http://www.aspose.com/")
#  Specify the screen tip
hlink.screen_tip = "Click to go to Aspose site"
dataDir = dataDir + "ImageHyperlink.out.xls"
#  Save the Excel file
workbook.save(dataDir)