Ajouter un filigrane à une feuille Excel en Java

Des filigranes peuvent être ajoutés aux documents soit pour protéger le document contre le piratage, soit pour afficher tout symbole ou message. Dans d’autres articles, nous avons discuté des moyens de filigraner différents documents, images et présentations. Dans cet article, vous apprendrez comment ajouter un filigrane aux classeurs Excel de différentes manières en Java. Nous appliquerons des filigranes séparément en utilisant chaque approche.

Les sujets suivants sont traités ci-dessous :

API Java pour filigraner des feuilles Excel

GroupDocs.Watermark pour Java est l’API permettant d’automatiser les filigranes pour les documents, les présentations, les images et de nombreux autres formats de fichiers. La liste complète des formats de documents pris en charge est disponible dans la documentation.

Vous pouvez télécharger le fichier JAR à partir de la section des téléchargements ou utiliser les dernières configurations de référentiel et de dépendance Maven dans vos applications Java.

<repository>
	<id>GroupDocsJavaAPI</id>
	<name>GroupDocs Java API</name>
	<url>https://repository.groupdocs.com/repo/</url>
</repository>
<dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-watermark</artifactId>
        <version>21.3</version> 
</dependency>

Filigraner des feuilles Excel à l’aide de Java

L’API de filigrane permet de personnaliser tout en insérant le filigrane dans les feuilles de calcul sous forme de texte. Voici les étapes pour ajouter des filigranes aux classeurs Excel en Java.

  • Chargez la feuille de calcul source à l’aide de Watermarker et SpreadsheetLoadOptions.
  • Définissez le texte du filigrane et les propriétés d’apparence à l’aide de TextWatermark.
  • Ajoutez le filigrane défini à la feuille de calcul Excel en utilisant add() mehtod.
  • Enregistrez la feuille de calcul résultante avec un filigrane à l’aide de la méthode save().

L’exemple de code Java suivant ajoute le filigrane de texte à toutes les feuilles du classeur Excel avec rotation et opacité et l’alignement défini.

/*
 * Ajouter un filigrane à toutes les feuilles du classeur Excel en Java
 */
// Charger la feuille de calcul
String filename = "path/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(filename, new SpreadsheetLoadOptions());

// Définir l'apparence du filigrane du texte
TextWatermark watermark = new TextWatermark("DRAFT", new Font("Segoe UI", 19));
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setVerticalAlignment(VerticalAlignment.Center);
watermark.setRotateAngle(-45);
watermark.setSizingType(SizingType.ScaleToParentDimensions);
watermark.setScaleFactor(0.5);
watermark.setOpacity(0.5);

// Ajouter un filigrane et enregistrer la feuille de calcul avec filigrane
watermarker.add(watermark);
watermarker.save("path/watermark-all-spreadsheet.xlsx");
watermarker.close();

Feuille Excel spécifique au filigrane à l’aide de Java

De même, vous pouvez également insérer des filigranes dans n’importe quelle feuille du classeur. Les étapes suivantes expliquent comment appliquer un filigrane de texte à la feuille spécifique du classeur Excel en Java.

  • Chargez la feuille de calcul à l’aide du Filigrane.
  • Définissez l’apparence et le texte du filigrane à l’aide de TextWatermark.
  • Définissez l’index de la feuille de calcul afin que le filigrane ne soit appliqué qu’à la feuille mentionnée.
  • Ajoutez le filigrane de texte à la feuille de calcul Excel à l’aide de la méthode add() avec les options de filigrane.
  • Enregistrez la feuille de calcul de sortie avec le filigrane à l’aide de la méthode save().

L’extrait de code Java suivant applique le filigrane de texte uniquement à la feuille mentionnée du classeur Excel.

/*
 * Ajouter un filigrane uniquement à la feuille mentionnée du classeur Excel à l'aide de Java
 */
// Charger la feuille de calcul
String filename = "path/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(filename, new SpreadsheetLoadOptions());

// Définir le filigrane du texte et son index de feuille de calcul
TextWatermark watermark = new TextWatermark("DRAFT", new Font("Segoe UI", 19));
SpreadsheetWatermarkModernWordArtOptions options = new SpreadsheetWatermarkModernWordArtOptions();               
options.setWorksheetIndex(0);

// Ajouter un filigrane et enregistrer la feuille de calcul avec filigrane
watermarker.add(watermark, options);
watermarker.save("path/watermark-single-sheet.xlsx");
watermarker.close();

Filigrane des feuilles Excel en arrière-plan à l’aide de Java

De même, nous pouvons également ajouter des filigranes comme arrière-plan de la feuille de calcul. Il y aura quelques modifications à l’approche ci-dessus pour appliquer des filigranes. Voici les étapes qui insèrent un filigrane de texte d’arrière-plan dans une feuille de calcul Excel en Java.

  • Chargez la feuille de calcul à l’aide de Filigrane.
  • Préparez le texte du filigrane et son apparence à l’aide de TextWatermark.
  • Définissez les paramètres du filigrane pour en faire un arrière-plan à l’aide des options de filigrane en obtenant le contenu et en définissant les dimensions.
  • Ajoutez le filigrane aux feuilles du classeur à l’aide de la méthode add().
  • Enfin, enregistrez la feuille de calcul en filigrane à l’aide de la méthode save().

L’exemple de code suivant peut être utilisé pour ajouter un filigrane de texte d’arrière-plan à une feuille de calcul Excel en Java.

/*
 * Ajouter un filigrane en arrière-plan au classeur Excel en Java
 */
// Charger la feuille de calcul
String filename = "path/spreadsheet.xlsx";
Watermarker watermarker = new Watermarker(filename, new SpreadsheetLoadOptions());

// Définir l'apparence du filigrane du texte
TextWatermark watermark = new TextWatermark("DRAFT", new Font("Segoe UI", 19));
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setVerticalAlignment(VerticalAlignment.Center);
watermark.setRotateAngle(-45);
watermark.setSizingType(SizingType.ScaleToParentDimensions);
watermark.setScaleFactor(0.5);
watermark.setOpacity(0.5);

// Ajouter un filigrane à l'arrière-plan
SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
SpreadsheetBackgroundWatermarkOptions options = new SpreadsheetBackgroundWatermarkOptions();
options.setBackgroundWidth(content.getWorksheets().get_Item(0).getContentAreaWidthPx()); /* set background width */
options.setBackgroundHeight(content.getWorksheets().get_Item(0).getContentAreaHeightPx()); /* set background height */

// Enregistrer la feuille de calcul avec filigrane
watermarker.add(watermark, options);
watermarker.save("path/watermark-background-spreadsheet.xlsx");
watermarker.close();
Filigraner des feuilles Excel par programmation

Obtenez une licence API gratuite

Vous pouvez obtenir une licence temporaire gratuite afin d’utiliser l’API sans les limitations d’évaluation.

Conclusion

Dans cet article, nous avons expliqué comment ajouter des filigranes aux feuilles Excel de différentes manières dans l’application Java. Nous avons appris à insérer un filigrane de texte dans toutes les feuilles du classeur Excel, puis nous avons appliqué le filigrane à la feuille spécifique uniquement. Plus tard, nous avons appliqué le filigrane en arrière-plan. Vous pouvez maintenant utiliser cette fonctionnalité et créer votre propre application pour ajouter des filigranes aux feuilles de calcul.

En savoir plus sur l’API dans la documentation. Pour toute question, contactez-nous via le forum.

Voir également