Ajouter un filigrane à Excel avec GroupDocs.Watermark Java

L’ajout d’un filigrane à vos fichiers Excel peut changer la donne — que vous ayez besoin de protéger des données sensibles, de marquer vos rapports ou simplement d’ajouter une touche professionnelle. Dans ce tutoriel, vous apprendrez comment ajouter un filigrane à Excel aux feuilles de calcul en utilisant GroupDocs.Watermark pour Java, avec des explications claires, des cas d’utilisation concrets et des conseils pour éviter les pièges courants.

Réponses rapides

• Quelle bibliothèque faut‑il ? GroupDocs.Watermark for Java (dernière version).
• Quels formats Excel sont pris en charge ? fichiers .xlsx et .xls (non chiffrés).
• Puis‑je ajouter des filigranes image ? Oui – le SDK prend en charge les filigranes texte et image.
• Ai‑je besoin d’une licence pour la production ? Une licence commerciale est requise pour les déploiements hors période d’essai.
• Combien de temps prend l’implémentation ? Environ 10‑15 minutes pour un filigrane texte basique.

Qu’est‑ce que add watermark to excel ?

Ajouter un filigrane à un classeur Excel signifie apposer un texte ou une image visible (ou semi‑transparent) sur chaque feuille de calcul ou document intégré. Cela vous permet d’affirmer la propriété, d’indiquer la confidentialité ou de renforcer la marque sur l’ensemble du fichier.

Pourquoi utiliser GroupDocs.Watermark pour Java ?

GroupDocs.Watermark propose une API de haut niveau qui abstrait la complexité de la manipulation des structures Office Open XML. Elle vous permet de :

• Appliquer des filigranes à plusieurs feuilles de calcul en un seul appel.
• Gérer automatiquement les pièces jointes intégrées (p. ex. : PDFs intégrés).
• Conserver le formatage et les formules d’origine.
• Travailler avec les filigranes texte et image (p. ex. : add image watermark java).

Prérequis

• Environnement de développement Java – Java 8 ou supérieur (JDK).
• SDK GroupDocs.Watermark pour Java – téléchargez la dernière version depuis here.
• IDE – IntelliJ IDEA, Eclipse ou tout éditeur compatible Java.
• Feuille de calcul d’exemple – un fichier .xlsx que vous souhaitez protéger.

Vous pouvez ajouter le SDK à votre projet via Maven, Gradle, ou en plaçant manuellement les fichiers JAR sur le classpath.

Importer les packages

Ces imports vous donnent accès aux classes principales de filigrane, à la manipulation des feuilles de calcul et aux utilitaires de police.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.examples.Constants;
import com.groupdocs.watermark.domain.DocumentInfo;
import com.groupdocs.watermark.domain.FileType;
import com.groupdocs.watermark.domain.content.SpreadsheetContent;
import com.groupdocs.watermark.domain.content.SpreadsheetWorksheet;
import com.groupdocs.watermark.domain.content.SpreadsheetAttachment;
import com.groupdocs.watermark.domain.document.IDocumentInfo;
import com.groupdocs.watermark.domain.loadoptions.SpreadsheetLoadOptions;
import com.groupdocs.watermark.domain.wrappers.TextWatermark;
import java.awt.Font;

Comment watermark spreadsheet – Guide étape par étape

Ci‑dessous se trouve un guide pratique, numéroté, qui montre exactement comment watermark spreadsheet les fichiers avec Java. Chaque étape comprend une courte explication suivie du bloc de code original (inchangé).

Étape 1 : Configurer votre objet Watermark

Pourquoi ? Cet objet définit l’apparence visuelle du tampon que vous appliquerez.

TextWatermark watermark = new TextWatermark("Confidential", new Font("Arial", 19));

Étape 2 : Charger la feuille de calcul

Pourquoi ? Ouvrir le classeur fournit au SDK une référence pour l’éditer.

SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
Watermarker watermarker = new Watermarker("your-file-path.xlsx", loadOptions);

Étape 3 : Accéder au contenu de la feuille de calcul et aux feuilles de travail

Pourquoi ? Les fichiers Excel peuvent contenir de nombreuses feuilles ; vous devez itérer sur chacune d’elles.

SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
for (SpreadsheetWorksheet worksheet : content.getWorksheets()) {
    // Process each worksheet
}

Étape 4 : Parcourir les pièces jointes dans chaque feuille de calcul

Pourquoi ? Certaines feuilles intègrent d’autres documents (p. ex. : PDFs). Les gérer assure un filigrane cohérent sur l’ensemble du fichier.

for (SpreadsheetAttachment attachment : worksheet.getAttachments()) {
    IDocumentInfo info = attachment.getDocumentInfo();
    if (info.getFileType() != FileType.Unknown && !info.isEncrypted()) {
        // Process the supported attachment
    }
}

Étape 5 : Appliquer le filigrane à chaque document joint

Pourquoi ? Vous souhaitez le même tampon « Confidentiel » sur chaque fichier intégré.

Watermarker attachedWatermarker = attachment.createWatermarker();
attachedWatermarker.add(watermark);
attachment.updateContent(attachedWatermarker);
attachedWatermarker.close();

Étape 6 : Enregistrer toutes les modifications

Pourquoi ? Persister les modifications dans un nouveau classeur.

watermarker.save("your-output-file.xlsx");

Étape 7 : Fermer les ressources

Pourquoi ? Libérer les ressources évite les fuites de mémoire, surtout lors du traitement de gros classeurs.

watermarker.close();

Assemblage complet : Exemple complet

La classe suivante combine chaque étape en un seul programme exécutable. Ne modifiez pas le bloc de code – il est identique à l’exemple original.

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.domain.DocumentInfo;
import com.groupdocs.watermark.domain.FileType;
import com.groupdocs.watermark.domain.content.SpreadsheetContent;
import com.groupdocs.watermark.domain.content.SpreadsheetWorksheet;
import com.groupdocs.watermark.domain.content.SpreadsheetAttachment;
import com.groupdocs.watermark.domain.loadoptions.SpreadsheetLoadOptions;
import com.groupdocs.watermark.domain.wrappers.TextWatermark;
import java.awt.Font;

public class WatermarkSpreadsheet {
    public static void main(String[] args) {
        try {
            // Step 1: Create watermark
            TextWatermark watermark = new TextWatermark("Confidential", new Font("Arial", 19));
            
            // Step 2: Load spreadsheet
            SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();
            Watermarker watermarker = new Watermarker("path/to/your/spreadsheet.xlsx", loadOptions);
            
            // Step 3: Access content and worksheets
            SpreadsheetContent content = watermarker.getContent(SpreadsheetContent.class);
            for (SpreadsheetWorksheet worksheet : content.getWorksheets()) {
                
                // Step 4: Loop attachments
                for (SpreadsheetAttachment attachment : worksheet.getAttachments()) {
                    DocumentInfo info = attachment.getDocumentInfo();
                    if (info.getFileType() != FileType.Unknown && !info.isEncrypted()) {
                        
                        // Step 5: Watermark attached documents
                        Watermarker attachedWatermarker = attachment.createWatermarker();
                        attachedWatermarker.add(watermark);
                        attachment.updateContent(attachedWatermarker);
                        attachedWatermarker.close(); // Clean up
                    }
                }
            }
            // Step 6: Save modifications
            watermarker.save("path/to/output/spreadsheet_watermarked.xlsx");
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // Step 7: Close resources
            // (Ensure resources are closed)
        }
    }
}

Problèmes courants et solutions

Questions fréquentes

Q : Puis‑je ajouter un filigrane image au lieu du texte ?
R : Oui. Utilisez ImageWatermark du SDK et transmettez une instance java.awt.Image. Cela couvre le scénario add image watermark java.

Q : Comment contrôler la position du filigrane ?
R : La classe TextWatermark (ou ImageWatermark) offre des propriétés comme setHorizontalAlignment, setVerticalAlignment et setOpacity pour ajuster finement le placement et la transparence.

Q : Est‑il possible d’appliquer un filigrane à plusieurs fichiers Excel en une seule exécution ?
R : Absolument. Enveloppez le flux complet dans une boucle for qui itère sur un répertoire de fichiers, en réutilisant la même instance TextWatermark.

Q : Que se passe‑t‑il si la feuille de calcul contient des graphiques ?
R : Les graphiques sont traités comme des objets de dessin séparés ; le filigrane est appliqué sur le canevas de la feuille, ainsi les graphiques restent intacts mais sont tout de même recouverts par le tampon translucide.

Q : Puis‑je supprimer un filigrane ajouté précédemment ?
R : Le SDK inclut les méthodes watermarker.remove(watermark), mais vous devez conserver une référence à l’objet filigrane original ou rechercher par texte/contenu pour l’identifier.

Dernière mise à jour : 2026-03-27
Testé avec : GroupDocs.Watermark 23.12 (Java)
Auteur : GroupDocs