Gestionar hipervínculos en la hoja de trabajo

Este tema discute qué tipos de hipervínculos son admitidos en Aspose.Cells.GridWeb y cómo gestionarlos programáticamente. Los hipervínculos se pueden utilizar para crear enlaces a URL web o para realizar una devolución de llamada a un servidor.

Trabajando con hipervínculos

Tipos de hipervínculos

Generalmente, los siguientes hipervínculos son compatibles con Aspose.Cells.GridWeb:

• Hipervínculos de URL, hipervínculos que se pueden vincular a URLs web.
• Hipervínculos de texto, hipervínculos de URL aplicados al texto.
• Hipervínculos de imagen, hipervínculos de URL aplicados a imágenes.
• Hipervínculos de comando de celda, hipervínculos que envían datos a un servidor. Tales hipervínculos actúan más como un botón que desencadena un evento del lado del servidor al hacer clic.

Las siguientes secciones describen el uso de todos los tipos de hipervínculos en detalle. También se discute cómo acceder o eliminar enlaces.

Añadiendo hipervínculos

Hipervínculos de URL

Los URL de hipervínculo se parecen más a hipervínculos simples que normalmente se ven en sitios web. Un URL de hipervínculo funciona como un ancla en una celda. Cuando se hace clic en él, navega a una página web o abre una nueva ventana del navegador.

Existen diferentes tipos de URL de hipervínculo:

• Hipervínculos de texto.
• Hipervínculos de imagen.

Los desarrolladores pueden especificar una imagen para el hipervínculo. Si no se especifica una imagen, se crea un hipervínculo de texto; de lo contrario, se crea un hipervínculo de imagen.

Hipervínculos de texto

Para agregar un hipervínculo de texto a una hoja de cálculo:

1. Agrega el control Aspose.Cells.GridWeb a tu Formulario Web.
2. Acceder a una hoja de cálculo.
3. Agregar un hipervínculo a una celda en la hoja de cálculo.
4. Establecer el texto que se mostrará en la celda.
5. Establecer el URL del hipervínculo.
6. Establecer el destino del hipervínculo, si se desea.
7. Establecer una descripción, si se desea.

NOTA: El destino del hipervínculo puede definirse como _self, _top o _parent para abrir URL web en una ventana nueva, la actual o en la superior respectivamente.

El siguiente ejemplo añade dos hipervínculos a una hoja de cálculo. Uno sin destino y el otro con destino a _parent.

Resultado: hipervínculos de texto agregados a la hoja de cálculo

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Adds a text hyperlink that goes to Aspose site and opens in new window
int linkIndex = sheet.Hyperlinks.Add("B1", "http://www.aspose.com");
GridHyperlink link1 = sheet.Hyperlinks[linkIndex];
link1.Target = "_blank";

// Setting text and tool tip of the hyperlink
link1.TextToDisplay = "Aspose";
link1.ScreenTip = "Open Aspose Web Site in new window";
 
// Adding hyperlink to the worksheet to open in parent window
linkIndex = sheet.Hyperlinks.Add("B2", "http://www.aspose.com/docs/display/cellsnet/Aspose.Cells.GridWeb");
GridHyperlink link2 = sheet.Hyperlinks[linkIndex];
link2.Target = "_parent";

// Setting text and tool tip of the hyperlink
link2.TextToDisplay = "Aspose.Grid Docs";
link2.ScreenTip = "Open Aspose.Grid Docs in parent window";

Hipervínculos de imagen

Para añadir un hipervínculo de imagen:

1. Agrega el control Aspose.Cells.GridWeb a tu Formulario Web.
2. Acceder a una hoja de cálculo.
3. Agregar un hipervínculo a una celda.
4. Establecer la URL de la imagen que se mostrará como hipervínculo.
5. Establecer la URL del hipervínculo.
6. Establecer una descripción, si se desea.
7. Establecer el texto del hipervínculo, si se desea.

Salida: hipervínculos de imagen agregados a la hoja de cálculo

Setting the image hyperlink’s AltText fills a similar function as setting an tag in HTML. The text is displayed only if the hyperlinked image is not displayed. (For example, if the image isn’t at the specified location.) If the image of the second hyperlink is not found, the output of the code snippet below would look as follows.

La imagen para la URL de la imagen no se pudo encontrar

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Adding hyperlink to the worksheet
int linkIndex = sheet.Hyperlinks.Add("B5", "http://www.aspose.com");
GridHyperlink link1 = sheet.Hyperlinks[linkIndex];
link1.Target = "_blank";

// Setting Image URL and tool tip of hyperlink
link1.ImageURL = "../Images/Aspose.Banner.gif";
link1.ScreenTip = "Open Aspose Web Site in new window";

// Adding hyperlink to the worksheet
linkIndex = sheet.Hyperlinks.Add("B6", "http://www.aspose.com/docs/display/cellsnet/Aspose.Cells.GridWeb");
GridHyperlink link2 = sheet.Hyperlinks[linkIndex];
link2.Target = "_blank";

// Setting URL, tool tip and alt text of hyperlink
link2.ImageURL = "../Images/Aspose.Grid.gif";
link2.ScreenTip = "Open Aspose.Grid Docs in new window";
link2.AltText = "Open Aspose.Grid Docs in new window";

// Resize the rows to display image nicely
sheet.Cells.SetRowHeight(4, 40);
sheet.Cells.SetRowHeight(5, 40);

Hipervínculos de Comando de Celda

Un hipervínculo de comando de celda es un tipo especial de hipervínculo que activa un evento del lado del servidor en lugar de abrir una página web. Los desarrolladores pueden agregar código al evento del lado del servidor y realizar cualquier tarea cuando se hace clic en el hipervínculo. Esta característica permite a los desarrolladores crear aplicaciones más interactivas.

Para agregar un hipervínculo de comando de celda:

1. Agrega el control Aspose.Cells.GridWeb a tu Formulario Web.
2. Acceder a una hoja de cálculo.
3. Agregar un hipervínculo a una celda.
4. Establecer el comando del hipervínculo al valor deseado. El valor es utilizado por el manejador de eventos del hipervínculo para reconocerlo.
5. Establecer una descripción, si se desea.
6. Establecer la URL de la imagen que se mostrará como hipervínculo.

Se ha agregado un hipervínculo de comando de celda a la hoja de cálculo

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Adding hyperlink to the worksheet
int linkIndex = sheet.Hyperlinks.Add("B8", "");
GridHyperlink link1 = sheet.Hyperlinks[linkIndex];

// Setting the cell command, tool tip and image URL for the hyperlink
link1.Command = "Click";
link1.ScreenTip = "Click Here";
link1.ImageURL = "../Images/button.jpg";

// Resize the row to display image nicely
sheet.Cells.SetRowHeight(7, 30);

Manejo de Eventos de Hipervínculos de Comando de Celda

Los desarrolladores necesitan crear un controlador de eventos para el evento CellCommand del control GridWeb para realizar tareas específicas cuando se hace clic en un hipervínculo de comando de celda específico. El controlador de eventos del evento CellCommand proporciona un objeto del tipo CellEventArgs que ofrece la propiedad Argument. Use la propiedad Argument para identificar un hipervínculo específico comparando su valor CellCommand.

El ejemplo a continuación crea un controlador de eventos para el hipervínculo de comando de celda creado en el código anterior. El CellCommand del hipervínculo se estableció en Click. Entonces, en el controlador de eventos, primero verifíquelo y luego agregue código que muestre un mensaje en la celda A6.

El controlador de eventos se invoca cuando se hace clic en el hipervínculo.

Salida: texto agregado a la celda A6 cuando se hace clic en el hipervínculo

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Event Handler for CellCommand event
protected void GridWeb1_CellCommand(object sender, Aspose.Cells.GridWeb.CellEventArgs e)
{
    // Checking the CellCommand of the hyperlink
    if (e.Argument.Equals("Click"))
    {
        // Accessing the reference of the worksheet that is currently active
        GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

        // Adding value to "C8" cell
        sheet.Cells["C8"].PutValue("Cell Command Hyperlink Clicked");

        // Resize the column to display message nicely
        sheet.Cells.SetColumnWidth(2, 250);
    }
}

Accediendo a los hipervínculos

Para acceder a un hipervínculo existente:

1. Acceda a la celda que lo contiene.
2. Obtenga la referencia de la celda.
3. Pase la referencia al método GetHyperlink de la colección Hyperlinks para acceder al hipervínculo.
4. Modifique las propiedades del hipervínculo.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Accessing a specific cell that contains hyperlink
GridCell cell = sheet.Cells["B1"];

// Accessing the hyperlink from the specific cell
GridHyperlink link = sheet.Hyperlinks.GetHyperlink(cell);

if (link != null)
{
    // Modifying the text and URL of hyperlink
    link.TextToDisplay = "Aspose.Blogs";
    link.Address = "http://www.aspose.com/Community/Blogs";
} 

Eliminando hipervínculos

Para eliminar un hipervínculo:

1. Accede a la hoja de cálculo activa.
2. Elimine un hipervínculo utilizando el método Remove de la colección Hyperlinks.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];
            
// Removing hyperlink from the specific cell         
sheet.Hyperlinks.Remove(new Data.GridCellArea() {StartRow = 0, EndRow = 0, StartColumn = 1, EndColumn = 1});