Version

Hyperlinks Interactions (XamSpreadsheet)

Purpose

This topic explains what actions can be performed by the user when interacting with hyperlinks.

Required background

The following table lists the concept and topics required as a prerequisite to understanding this topic.

Type Content

Concept

Infragistics Excel Engine

Topic Purpose

In this section you will find information that will help you to better understand the object model and the functionalities of the Infragistics Excel Engine .

This topic explains in details the features of the XamSpreadsheet control from developer perspective.

This topic provides an overview of the visual elements of the XamSpreadsheet control.

This topic explains the supported user actions when navigating the control’s cells.

In this topic

This topic contains the following sections:

Introduction

The XamSpreadsheet control supports hyperlinks which are special text objects that can navigate the user to a specific location once clicked. Here is a list of the supported locations:

  • Worksheet cell (may be in different worksheet)

  • Worksheet cell range (may be in different worksheet)

  • Named reference

  • All other targets (like files, email address or internet address) are handled by the OS

Hyperlinks also supports tooltips when hovered with the mouse.

The following screenshot shows a hyperlink which display text is "Infragistics", its target is set to the Infragistics website and the tooltip is shown because the hyperlinks is hovered.

xamSpreadsheet 16.png
Note
Note

For more information on how to create and customize hyperlinks in code look at the Adding a Hyperlink to a Worksheet (Infragistics Excel Engine) topic.

Followed State

Followed state summary

The XamSpreadsheet control supports a followed state for each hyperlink instance. This state is transient and will be retained until the moment you close the opened workbook. After reopening the workbook all links will have they followed state cleared.

When the user clicks a hyperlink this will set its followed state and also change the rendering of the hyperlinks by using different style (by default followed hyperlinks are rendered brownish and underlined).

The followed state is tracked by hyperlink’s instance (not by hyperlink’s target location) which means if you have more than one hyperlink targeting the same location only the clicked hyperlinks will be rendered as followed.

User Interactions and Usability

User interactions summary chart

The following table summarizes the user interaction capabilities of the XamSpreadsheet's hyperlinks.

The user can… Using… Details Configurable?

Follow a hyperlink

  • Click on the hyperlink

  • Right click on a cell(s) containing hyperlink and choose the “Open Hyperlink” menu item

After clicking this hyperlink it followed state will be set and it will be rendered differently.

Select a cell that contains hyperlink

  • Click on an empty space around the hyperlink

  • Press mouse button on the hyperlink and hold it pressed for a second

N/A

No.png

Show a hyperlink’s tooltip

Hover the hyperlink with the mouse

The tooltip will be hidden once the mouse leaves the hyperlinks bounds

Note
Note

There are user options for opening and removing hyperlinks available in the XamSpreadsheet's context menus which are described in the Context Menu Interactions (XamSpreadsheet) topic.

Related Content

The following topics provide additional information related to this topic.

Topic Purpose

This topic explains what action can be performed by the user when editing cells.

This topic explains what actions can be performed by the user when interacting with worksheet columns and rows.

This topic explains the supported user actions when selecting cells, rows, or columns.

This topic explains what operations can be performed by the user with the control’s context menu.

This topic explains what type of hyperlinks are supported and how to operate with them.