Insertar hipervínculos en Excel u OpenOffice

Un hipervínculo se usa para crear un enlace entre dos entidades. Todos están familiarizados con el uso de hipervínculos, especialmente en sitios web. Utilizando Aspose.Cells, los desarrolladores pueden crear diferentes tipos de hipervínculos en archivos de Microsoft Excel. Este tema discute qué tipos de hipervínculos son compatibles con Aspose.Cells y cómo se pueden usar en nuestros archivos de Excel.

Añadiendo hipervínculos

Aspose.Cells permite a los desarrolladores agregar hipervínculos a archivos de Excel usando la API o hojas de cálculo de diseño (hojas donde los hipervínculos se crean manualmente y Aspose.Cells se usa para importarlos en otras hojas).

Aspose.Cells proporciona una clase, Workbook que representa un archivo de Microsoft Excel. La clase Workbook contiene una WorksheetCollection que permite acceder a cada hoja del archivo de Excel. Una hoja se representa por la clase Worksheet. La clase Worksheet ofrece diferentes métodos para agregar distintos hipervínculos a archivos de Excel.

Añadir un enlace a una URL

La clase Worksheet contiene una colección getHyperlinks(). Cada elemento en la colección getHyperlinks() representa un Hyperlink. Agrega hipervínculos a URLs llamando al método add de la colección Hyperlinks. El método add acepta los siguientes parámetros:

• Nombre de la celda, el nombre de la celda a la que se agregará el hipervínculo.
• Número de filas, el número de filas en este rango de hipervínculo.
• Número de columnas, el número de columnas en este rango de hipervínculo.
• URL, la dirección de la URL.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Create directory if it is not already present.
const fs = require("fs");
if (!fs.existsSync(dataDir)) {
    fs.mkdirSync(dataDir);
}

// Instantiating a Workbook object
let workbook = new AsposeCells.Workbook();

// Obtaining the reference of the first worksheet
let worksheet = workbook.getWorksheets().get(0);

// Adding a hyperlink to a URL at "A1" cell
worksheet.getHyperlinks().add("A1", 1, 1, "http://www.aspose.com");

// Saving the Excel file
workbook.save(path.join(dataDir, "output.out.xls"));

En el ejemplo anterior, se añade un hipervínculo a una URL en una celda vacía, A1. En tales casos, si una celda está vacía, entonces la dirección URL también se agrega a esa celda vacía como su valor. Si la celda no está vacía y se agrega un hipervínculo, el valor de la celda se ve como texto plano. Para que se vea como un hipervínculo, aplique la configuración de formato adecuada en esa celda.

Añadir un enlace a una celda en el mismo archivo

Es posible agregar hipervínculos a celdas en el mismo archivo de Excel llamando al método add de la colección Hyperlinks. El método add funciona para hipervínculos internos y externos. Una versión del método sobrecargado acepta los siguientes parámetros:

• Nombre de la celda, el nombre de la celda a la que se agregará el hipervínculo.
• Número de filas, el número de filas en este rango de hipervínculo.
• Número de columnas, el número de columnas en este rango de hipervínculo.
• URL, la dirección de la celda de destino.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Create directory if it is not already present.
const fs = require("fs");
if (!fs.existsSync(dataDir)) {
    fs.mkdirSync(dataDir);
}

// Instantiating a Workbook object
let workbook = new AsposeCells.Workbook();

// Adding a new worksheet to the Workbook object
workbook.getWorksheets().add();

// Obtaining the reference of the first (default) worksheet
let worksheet = workbook.getWorksheets().get(0);

// Adding an internal hyperlink to the "B3" cell of the other worksheet "Sheet2" in
// The same Excel file
worksheet.getHyperlinks().add("B3", 1, 1, "Sheet2!B9");

// Saving the Excel file
workbook.save(path.join(dataDir, "output.out.xls"));

Agregar un enlace a un archivo externo

Es posible agregar hipervínculos a archivos de Excel externos llamando al método add de la colección Hyperlinks. El método add acepta los siguientes parámetros:

• Nombre de la celda, el nombre de la celda a la que se agregará el hipervínculo.
• Número de filas, el número de filas en este rango de hipervínculo.
• Número de columnas, el número de columnas en este rango de hipervínculo.
• URL, la dirección del destino, archivo externo de Excel.

const path = require("path");
const AsposeCells = require("aspose.cells.node");

// The path to the documents directory.
const dataDir = path.join(__dirname, "data");

// Instantiating a Workbook object
const workbook = new AsposeCells.Workbook();

// Adding a new worksheet to the Excel object
const i = workbook.getWorksheets().add();

// Obtaining the reference of the newly added worksheet by passing its sheet index
const worksheet = workbook.getWorksheets().get(i);

// Adding an internal hyperlink to the "B9" cell of the other worksheet "Sheet2" in
// The same Excel file
worksheet.getHyperlinks().add("A5", 1, 1, path.join(dataDir, "book1.xls"));

// Saving the Excel file
workbook.save(path.join(dataDir, "output.out.xls"));

Temas avanzados

• Agregar hipervínculos de imagen
• Detectar tipo de hipervínculo
• Editando Hipervínculos de la Hoja de Cálculo
• Obtener Hipervínculos en Rango