Lavorare con Watermark

In questo argomento viene illustrato come lavorare a livello di programmazione con una filigrana utilizzando Aspose.Words. Una filigrana è un’immagine di sfondo che viene visualizzata dietro il testo di un documento. Una filigrana può contenere un testo o un’immagine rappresentata dalla classe Watermark.

Aggiungere una filigrana a un documento

In Microsoft Word, una filigrana può essere facilmente inserita in un documento utilizzando il comando Inserisci filigrana. Aspose.Words fornisce la classe watermark per aggiungere o rimuovere la filigrana nei documenti. Aspose.Words fornisce l’enumerazione WatermarkType che definisce tre possibili tipi di filigrane (Testo, Immagine e Nessuna) con cui lavorare.

Aggiungi filigrana di testo

Nell’esempio di codice seguente viene illustrato come inserire una filigrana di testo in un documento definendo TextWatermarkOptions utilizzando il metodo SetText:

Aggiungi Filigrana immagine

Nell’esempio di codice seguente viene illustrato come inserire una filigrana di immagine in un documento definendo ImageWatermarkOptions utilizzando il metodo SetImage:

La filigrana può anche essere inserita usando la classe shape. È molto facile inserire qualsiasi forma o immagine in un’intestazione o piè di pagina e quindi creare una filigrana di qualsiasi tipo immaginabile.

L’esempio di codice seguente inserisce una filigrana in un documento di Word:

Rimuovere la filigrana da un documento

La classe Watermark fornisce il metodo Remove per rimuovere la filigrana da un documento.

Gli esempi di codice seguenti mostrano come rimuovere una filigrana dai documenti:

Per rimuovere la filigrana da un documento è necessario impostare solo il nome della forma filigrana durante l’inserimento e quindi rimuovere la forma filigrana con un nome assegnato.

L’esempio di codice seguente mostra come impostare il nome della forma della filigrana e rimuoverla dal documento:

// Set name to be able to remove it afterwards
watermark.Name("WaterMark");

Aggiungere una filigrana in una cella di tabella

A volte è necessario inserire una filigrana/immagine nella cella di una tabella e visualizzarla all’esterno della tabella, è possibile utilizzare la proprietà IsLayoutInCell. Questa proprietà ottiene o imposta un flag che indica se la forma viene visualizzata all’interno di una tabella o all’esterno di essa. Si noti che questa proprietà funziona solo quando si ottimizza il documento per Microsoft Word 2010 utilizzando il metodo OptimizeFor.

Il seguente esempio di codice mostra come utilizzare questa proprietà: