Spread for ASP.NET 12 Product Documentation
Setting a Hyperlink Cell
Spread for ASP.NET 12 Product Documentation > Developer's Guide > Customizing with Cell Types > Working with Graphical Cell Types > Setting a Hyperlink Cell

A hyperlink cell displays either text or an image that can serve as a hyperlink when clicked. The destination universal resource locator (URL), sometimes called the address, in the hyperlink can be any valid URL, such as www.yoursite.com or emailto:support@fpoint.com. For up-level browsers that support it, a text tip appears with the destination URL when the cursor pauses over the hyperlink cell. For down-level browsers, the status bar displays the URL when the cursor is over the link.

You can specify the target in which to display the destination, for example a new window (target = "_blank") or the same window (target= "_self").

Hyperlink Cell Example with text tip

To create a cell that acts like a hyperlink, follow the procedure described here.

For details on the properties and methods for this cell type, refer to the HyperLinkCellType class in the Assembly Reference.

Using Code

  1. Define the hyperlink cell type by creating an instance of the HyperLinkCellType class.
  2. Choose the graphic, if you are making a hyperlink with a graphical image, and make sure the graphic file is in the correct directory and is the correct file type for the browser to display it.
  3. Set the size of the cell, if you want it to match the size of a graphic to be used in the hyperlink.
  4. Specify the destination URL for the hyperlink. You can optionally set the target. The destination URL is displayed as text if the cell does not use a graphic.
  5. Assign the hyperlink cell to a cell (or cells).

Example

This example sets the size of the cell (by column and row) so that the graphic fits in it, then defines the location of the graphic to use as a hyperlink button, then specifies the destination URL (and has it opening is a separate window).

C#
Copy Code
FpSpread1.ActiveSheetView.Columns[1].Width = 145;
FpSpread1.ActiveSheetView.Rows[1].Height = 45;
string linkImage = @"images\fplogo.jpg";
string linkURL = "http://www.componentone.com";
string linkTarget = "_blank";
FarPoint.Web.Spread.HyperLinkCellType linkcell = new FarPoint.Web.Spread.HyperLinkCellType();
linkcell.ImageUrl = linkImage;
linkcell.NavigateUrl = linkURL;
linkcell.Target = linkTarget;
FpSpread1.ActiveSheetView.Cells[1, 1].CellType = linkcell; 
VB
Copy Code
FpSpread1.ActiveSheetView.Columns(1).Width = 145
FpSpread1.ActiveSheetView.Rows(1).Height = 45
Dim linkimage As String = "images\fplogo.jpg"
Dim linkURL As String = "http://www.componentone.com"
Dim linkTarget As String = "_blank"
Dim linkcell As New FarPoint.Web.Spread.HyperLinkCellType()
linkcell.ImageUrl = linkImage
linkcell.NavigateUrl = linkURL
linkcell.Target = linkTarget
FpSpread1.ActiveSheetView.Cells(1, 1).CellType = linkcell 

Using the Spread Designer

  1. In the work area, select the cell or cells for which you want to set the cell type.
  2. Select the Home menu.
  3. Select the SetCellType icon under the CellType section.
  4. Select the cell type and any other cell properties.
  5. Select OK to close the dialog.
  6. Click Apply and Exit to close the Spread Designer.
See Also