Aggiungi filigrana di testo a Excel usando Java – GroupDocs.Watermark

Nell’era digitale odierna, proteggere le informazioni sensibili nei fogli di calcolo è fondamentale. Add text watermark excel file facilmente con GroupDocs.Watermark per Java, una libreria che consente di incorporare filigrane di testo personalizzate direttamente nei workbook Excel. Questo tutorial ti guida attraverso l’installazione, l’uso di base e la stilizzazione avanzata così puoi proteggere i documenti mantenendo coerente il branding.

Risposte rapide

  • What does the library do? Che cosa fa la libreria? Inserisce filigrane di testo personalizzabili nei file Excel senza alterare il contenuto originale.
  • Which version is required? Quale versione è richiesta? GroupDocs.Watermark per Java 24.11 o successiva.
  • Do I need a license? Ho bisogno di una licenza? Una prova gratuita funziona per la valutazione; una licenza permanente rimuove tutte le limitazioni.
  • Can I target a single sheet? Posso mirare a un singolo foglio? Sì – è possibile applicare filigrane a fogli di lavoro specifici.
  • Is it fast on large files? È veloce su file di grandi dimensioni? Sì, elabora workbook di centinaia di pagine usando lo streaming, mantenendo basso l’uso della memoria.

Cos’è “add text watermark excel”?

Add text watermark excel si riferisce al processo di inserimento di una sovrapposizione di testo visibile in un workbook Excel per indicare riservatezza, proprietà o branding. Questa sovrapposizione è memorizzata come parte del file e rimane visibile quando il foglio di calcolo è aperto in qualsiasi visualizzatore compatibile.

Perché usare GroupDocs.Watermark per Java?

GroupDocs.Watermark supporta 30+ input and output formats e può elaborare file Excel fino a 200 MB senza caricare l’intero workbook in memoria, offrendo prestazioni inferiori al secondo su hardware server tipico. La sua API è completamente thread‑safe, rendendola ideale per pipeline enterprise ad alto throughput.

Prerequisiti

  1. Libraries and Dependencies
    • GroupDocs.Watermark per Java (Version 24.11 o successiva)
  2. Environment Setup
    • Un Java Development Kit (JDK) 8 o più recente installato
  3. Knowledge Requirements
    • Conoscenze di base di programmazione Java
    • Familiarità con Maven per la gestione delle dipendenze

Come aggiungere filigrana di testo a Excel – Guida passo‑passo

Per incorporare una filigrana di testo in un workbook Excel devi prima caricare il file con il Watermarker, quindi definire l’aspetto della filigrana e infine applicarla ai fogli desiderati prima di salvare. Il processo è semplice e può essere implementato con poche righe di codice Java, come mostrato negli snippet qui sotto.

Passo 1: Carica il documento Excel

Direct answer: Inizializza la classe Watermarker con il percorso del tuo file Excel e le opzioni di caricamento appropriate – questo prepara il documento per le operazioni di filigrana.

```xml
<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/watermark/java/</url>
   </repository>
</repositories>

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-watermark</artifactId>
      <version>24.11</version>
   </dependency>
</dependencies>


### Passo 2: Crea e configura la filigrana di testo
**Direct answer:** Istanzia un `TextWatermark`, imposta il suo testo, font, dimensione, colore e allineamento, quindi collegalo a un oggetto `SpreadsheetWatermarkOptions`.  

import com.groupdocs.watermark.Watermarker;
import com.groupdocs.watermark.contents.SpreadsheetLoadOptions;

// Initialize load options
SpreadsheetLoadOptions loadOptions = new SpreadsheetLoadOptions();

// Create a watermarker instance for the Excel file
Watermarker watermarker = new Watermarker("YOUR_DOCUMENT_DIRECTORY/spreadsheet.xlsx", loadOptions);


### Passo 3: Applica la filigrana ai fogli desiderati
**Direct answer:** Usa il metodo `add` sull'istanza `Watermarker`, passando le opzioni e opzionalmente specificando un indice di foglio per mirare a un singolo worksheet.  

import com.groupdocs.watermark.options.HorizontalAlignment;
import com.groupdocs.watermark.options.VerticalAlignment;
import com.groupdocs.watermark.watermarks.Color;
import com.groupdocs.watermark.watermarks.Font;
import com.groupdocs.watermark.watermarks.TextWatermark;

// Create a text watermark
TextWatermark watermark = new TextWatermark("Confidential", new Font("Segoe UI", 19));

// Set size, alignment and color of the watermark
watermark.setSizingType(TextWatermark.SIZING_TYPE.FIT_TO_PAGE);
watermark.setHorizontalAlignment(HorizontalAlignment.Center);
watermark.setVerticalAlignment(VerticalAlignment.Center);


### Passo 4: Salva il workbook con filigrana
**Direct answer:** Chiama `save` sul `Watermarker`, fornendo il percorso di output e il formato; la libreria scrive il file con filigrana preservando i dati originali.  

// Save the watermarked document
watermarker.save("YOUR_OUTPUT_DIRECTORY/spreadsheet_watermarked.xlsx");

// Release resources
watermarker.close();


## Applicare effetti di testo alle filigrane nei fogli di calcolo
Migliora la visibilità con stili di linea, opacità e rotazione.

### Personalizza il formato della linea
**Definition anchor:** `SpreadsheetTextEffects` è una classe di supporto che definisce lo spessore della linea, lo stile dash e il colore per le filigrane di testo nei fogli di calcolo.  

import com.groupdocs.watermark.options.SpreadsheetLineFormat;
import com.groupdocs.watermark.options.SpreadsheetDashStyle;
import com.groupdocs.watermark.options.SpreadsheetLineStyle;

// Set up text effects for the watermark
SpreadsheetTextEffects effects = new SpreadsheetTextEffects();
effects.getLineFormat().setEnabled(true);
effects.getLineFormat().setColor(Color.getRed());
effects.getLineFormat().setDashStyle(SpreadsheetDashStyle.DashDotDot);
effects.getLineFormat().setLineStyle(SpreadsheetLineStyle.Triple);
effects.getLineFormat().setWeight(1);


### Applica gli effetti alle opzioni della filigrana
Integra `SpreadsheetTextEffects` in `SpreadsheetWatermarkOptions` per controllare come la filigrana viene renderizzata su ogni pagina.

import com.groupdocs.watermark.options.SpreadsheetWatermarkShapeOptions;

// Attach effects to the watermark shape options
SpreadsheetWatermarkShapeOptions options = new SpreadsheetWatermarkShapeOptions();
options.setEffects(effects);


## Applicazioni pratiche
I fogli di calcolo con filigrana di testo sono utili in molti scenari:
1. **Confidential Reports** – Contrassegna i bilanci finanziari come “Confidential” per scoraggiare le perdite.  
2. **Branding** – Sovrapponi il logo o lo slogan della tua azienda ai fogli di calcolo destinati ai clienti.  
3. **Legal Documentation** – Etichetta chiaramente contratti e accordi per stabilire l'autenticità.  

## Considerazioni sulle prestazioni
Quando si gestiscono grandi workbook Excel, segui queste best practice:
- **Stream instead of load:** GroupDocs.Watermark elabora i dati in modalità streaming, evitando l'allocazione di memoria per l'intero documento.  
- **Close resources promptly:** Usa try‑with‑resources o chiamate esplicite a `close()` per liberare i handle dei file.  
- **Tune the JVM:** Aumenta la dimensione dell'heap (`-Xmx2g`) per file superiori a 100 MB, ma monitora le pause del GC.  

## Conclusione
Ora sai come **add text watermark excel** file usando GroupDocs.Watermark per Java, dall'inserimento di base allo styling avanzato. Sperimenta con diversi font, colori e angoli di rotazione per adattarli all'identità aziendale e integra il flusso di lavoro in pipeline di elaborazione documenti più ampie per una protezione automatizzata.

## Domande frequenti

**Q:** Qual è la dimensione massima del file supportata da GroupDocs.Watermark?  
**A:** La libreria può elaborare workbook Excel fino a **200 MB** senza degradare le prestazioni, grazie alla sua architettura di streaming.

**Q:** Posso personalizzare gli stili e le dimensioni del font?  
**A:** Sì – la classe `Font` consente di impostare famiglia, dimensione, stile (grassetto, corsivo) e colore per qualsiasi filigrana di testo.

**Q:** È possibile aggiungere filigrane solo a fogli specifici?  
**A:** Assolutamente. Usa la sovraccarico del metodo `add` che accetta un indice o un nome di foglio per mirare a worksheet individuali.

**Q:** Come devo gestire gli errori durante l'applicazione della filigrana?  
**A:** Avvolgi il tuo codice in un blocco try‑catch e cattura `IOException` e `WatermarkException` per gestire problemi di accesso ai file e errori API in modo elegante.

**Q:** Le filigrane possono essere rimosse in seguito, se necessario?  
**A:** Sì – GroupDocs.Watermark fornisce un'API `remove` che può eliminare le filigrane aggiunte precedentemente preservando il contenuto originale.

---

**Ultimo aggiornamento:** 2026-07-15  
**Testato con:** GroupDocs.Watermark per Java 24.11  
**Autore:** GroupDocs  

## Risorse
- [GroupDocs.Watermark for Java releases](https://releases.groupdocs.com/watermark/java/)
- [Documentation](https://docs.groupdocs.com/watermark/java/releases)

## Tutorial correlati

- [Add Image Watermark to Excel Spreadsheet Using GroupDocs.Watermark Java SDK](/watermark/java/spreadsheet-document-watermarking/add-image-watermark-spreadsheet-groupdocs-java/)
- [How to Add Attachments to Excel Using GroupDocs.Watermark Java for Spreadsheet Watermarking](/watermark/java/spreadsheet-document-watermarking/groupdocs-watermark-java-add-attachments-excel/)
- [Excel Spreadsheet Watermarking Tutorials for GroupDocs.Watermark Java](/watermark/java/spreadsheet-document-watermarking/)