Insérer des liens hypertexte dans Excel ou OpenOffice

Ajout de liens hypertexte pour lier des données

Ajout de liens hypertexte

Trois types de liens hypertexte peuvent être ajoutés à une cellule à l’aide d’Aspose.Cells :

Aspose.Cells permet aux développeurs d’ajouter des liens hypertexte aux fichiers Excel soit en utilisant l’API soit des feuilles de calcul conçues (feuilles de calcul où les liens hypertexte sont créés manuellement et Aspose.Cells est utilisé pour les importer dans d’autres feuilles de calcul).

Aspose.Cells fournit une classe Workbook qui représente un fichier Microsoft Excel. La classe Workbook contient une WorksheetCollection qui permet d’accéder à chaque feuille de calcul dans le fichier Excel. Une feuille de calcul est représentée par la classe Worksheet. La classe Worksheet fournit différentes méthodes pour ajouter différents liens hypertexte aux fichiers Excel.

Ajout de lien vers une URL

La classe Worksheet contient une collection Hyperlinks. Chaque élément dans la collection Hyperlinks représente un Hyperlink. Ajoutez des liens hypertexte vers des URLs en appelant la méthode Add  de la collection Hyperlinks. La méthode Add  prend les paramètres suivants :

  • Nom de la cellule, le nom de la cellule à laquelle le lien hypertexte sera ajouté.
  • Nombre de lignes, le nombre de lignes dans cette plage de liens hypertexte.
  • Nombre de colonnes, le nombre de colonnes de cette plage de liens hypertexte
  • URL, l’adresse URL.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingLinkToURL.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Obtaining the reference of the first worksheet.
WorksheetCollection worksheets = workbook.getWorksheets();
Worksheet sheet = worksheets.get(0);
HyperlinkCollection hyperlinks = sheet.getHyperlinks();
// Adding a hyperlink to a URL at "A1" cell
hyperlinks.add("A1", 1, 1, "http://www.aspose.com");
// Saving the Excel file
workbook.save(dataDir + "AddingLinkToURL_out.xls");
// Print message
System.out.println("Process completed successfully");

Dans l’exemple ci-dessus, un lien hypertexte est ajouté à une URL dans une cellule vide, A1. Dans de tels cas, si une cellule est vide, alors l’adresse URL est également ajoutée à cette cellule vide en tant que valeur. Si la cellule n’est pas vide et qu’un lien hypertexte est ajouté, la valeur de la cellule ressemble à du texte normal. Pour qu’elle ressemble à un lien hypertexte, appliquez les paramètres de mise en forme appropriés sur cette cellule.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingLinkToURLNotEmpty.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Obtaining the reference of the first worksheet.
WorksheetCollection worksheets = workbook.getWorksheets();
Worksheet sheet = worksheets.get(0);
// Setting a value to the "A1" cell
Cells cells = sheet.getCells();
Cell cell = cells.get("A1");
cell.setValue("Visit Aspose");
// Setting the font color of the cell to Blue
Style style = cell.getStyle();
style.getFont().setColor(Color.getBlue());
// Setting the font of the cell to Single Underline
style.getFont().setUnderline(FontUnderlineType.SINGLE);
cell.setStyle(style);
HyperlinkCollection hyperlinks = sheet.getHyperlinks();
// Adding a hyperlink to a URL at "A1" cell
hyperlinks.add("A1", 1, 1, "http://www.aspose.com");
// Saving the Excel file
workbook.save(dataDir + "AddingLinkToURLNotEmpty_out.xls");

Ajouter un lien vers une cellule dans le même fichier

Il est possible d’ajouter des liens hypertexte à des cellules dans le même fichier Excel en appelant la méthode Add  de la collection Hyperlinks. La méthode Add  fonctionne à la fois pour les liens hypertexte internes et externes. Une version de la méthode surchargée prend les paramètres suivants :

  • Nom de la cellule, le nom de la cellule à laquelle le lien hypertexte sera ajouté.
  • Nombre de lignes, le nombre de lignes dans cette plage de liens hypertexte.
  • Nombre de colonnes, le nombre de colonnes dans cette plage de liens hypertexte.
  • URL, l’adresse de la cellule cible.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingLinkToAnotherCell.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Obtaining the reference of the first worksheet.
WorksheetCollection worksheets = workbook.getWorksheets();
workbook.getWorksheets().add();
Worksheet sheet = worksheets.get(0);
// Setting a value to the "A1" cell
Cells cells = sheet.getCells();
Cell cell = cells.get("A1");
cell.setValue("Visit Aspose");
// Setting the font color of the cell to Blue
Style style = cell.getStyle();
style.getFont().setColor(Color.getBlue());
// Setting the font of the cell to Single Underline
style.getFont().setUnderline(FontUnderlineType.SINGLE);
cell.setStyle(style);
HyperlinkCollection hyperlinks = sheet.getHyperlinks();
// Adding an internal hyperlink to the "B9" cell of the other worksheet "Sheet2" in the same Excel file
hyperlinks.add("B3", 1, 1, "Sheet2!B9");
// Saving the Excel file
workbook.save(dataDir + "ALinkTACell_out.xls");
// Print message
System.out.println("Process completed successfully");

Ajouter un lien vers un fichier externe

Il est possible d’ajouter des hyperliens vers des fichiers Excel externes en appelant la méthode Hyperlinks de la collection Ajouter. La méthode Ajouter prend les paramètres suivants:

  • Nom de la cellule, le nom de la cellule à laquelle le lien hypertexte sera ajouté.
  • Nombre de lignes, le nombre de lignes dans cette plage de liens hypertexte.
  • Nombre de colonnes, le nombre de colonnes dans cette plage de liens hypertexte.
  • URL, l’adresse de la cible, fichier Excel externe.
// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(AddingLinkToExternalFile.class) + "data/";
// Instantiating a Workbook object
Workbook workbook = new Workbook();
// Obtaining the reference of the first worksheet.
WorksheetCollection worksheets = workbook.getWorksheets();
Worksheet sheet = worksheets.get(0);
// Setting a value to the "A1" cell
Cells cells = sheet.getCells();
Cell cell = cells.get("A1");
cell.setValue("Visit Aspose");
// Setting the font color of the cell to Blue
Style style = cell.getStyle();
style.getFont().setColor(Color.getBlue());
// Setting the font of the cell to Single Underline
style.getFont().setUnderline(FontUnderlineType.SINGLE);
cell.setStyle(style);
HyperlinkCollection hyperlinks = sheet.getHyperlinks();
// Adding a link to the external file
hyperlinks.add("A5", 1, 1, dataDir + "book1.xls");
// Saving the Excel file
workbook.save(dataDir + "ALToEFile_out.xls");
// Print message
System.out.println("Process completed successfully");

Sujets avancés