Lavorare con le filigrane

Lavorare con le filigrane

Questa guida mostra come aggiungere, configurare e rimuovere le filigrane dei documenti in Aspose.Words FOSS per .NET usando il Watermark classe, raggiunta tramite Document.Watermark. Una filigrana può essere testo o un’immagine, e solo una filigrana è attiva su un documento alla volta – impostarne una nuova sostituisce quella precedente.

Aggiungere una filigrana di testo

Watermark.SetText(text) aggiunge una filigrana di testo con formattazione predefinita. La sovraccarico SetText(text, options) accetta un’istanza TextWatermarkOptions per controllarne l’aspetto: FontFamily, Color e FontSize controllano la formattazione del testo, IsSemitrasparent commuta l’effetto semitrasparente tipico delle filigrane, e Layout (un valore WatermarkLayout — Horizontal o Diagonal) controlla la sua orientazione rispetto alla pagina.

Aggiungere una filigrana immagine

Watermark.SetImage(image) aggiunge una filigrana immagine da un Image già caricato. Le versioni sovraccaricate che accettano anche un’istanza ImageWatermarkOptions — SetImage(image, options), SetImage(imagePath, options) (caricamento da un percorso file) e SetImage(imageStream, options) (caricamento da un Stream) — ti permettono di controllare Scale (il fattore di scala dell’immagine, espresso come frazione) e IsWashout (l’effetto sbiadito che impedisce a un’immagine di filigrana di sovrastare il contenuto della pagina).

Verifica e rimozione di una filigrana

Watermark.Type riporta il tipo di filigrana corrente come un valore WatermarkType – Text, Image o None se nessuna filigrana è impostata. Chiama Watermark.Remove() per rimuovere la filigrana corrente dal documento.

Suggerimenti e migliori pratiche

• Verifica Watermark.Type prima di presumere che una filigrana esista – restituisce WatermarkType.None su un documento che non ne ha mai avuto una impostata.
• Impostare una nuova filigrana tramite SetText() o SetImage() sostituisce qualsiasi filigrana esistente; non è possibile avere più di una filigrana attiva alla volta.
• Usa WatermarkLayout.Diagonal per riprodurre l’orientamento diagonale predefinito della filigrana di Word, o Horizontal per una filigrana che corre parallela ai bordi della pagina.
• Preferisci le overload ImageWatermarkOptions/TextWatermarkOptions rispetto alle chiamate semplici SetImage(image) / SetText(text) ogni volta che devi controllare l’opacità, la scala o il font – le overload senza parametri usano le impostazioni predefinite di Word.

Problemi comuni

FAQ

Come verifico se un documento ha già un watermark?

Leggi Document.Watermark.Type; restituisce WatermarkType.Text, WatermarkType.Image o WatermarkType.None.

Come rimuovo un watermark?

Chiama Document.Watermark.Remove().

Posso controllare la trasparenza del watermark?

Sì – per i watermark di testo, imposta TextWatermarkOptions.IsSemitrasparent; per i watermark di immagine, imposta ImageWatermarkOptions.IsWashout.

Come carico un watermark immagine dal disco invece di un Image in-memory?

Usa il sovraccarico Watermark.SetImage(imagePath, options), passando il percorso del file come stringa insieme a un’istanza ImageWatermarkOptions.

API Reference Riepilogo

Vedi anche

• Aspose.Words for .NET — Enterprise Documentation