Lavorare con la filigrana

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

Come 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 (TEXT, IMAGE e NONE) 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 set_text.

Aggiungi filigrana immagine

L’esempio di codice seguente dimostra come inserire una filigrana di immagine in un documento definendo ImageWatermarkOptions utilizzando il metodo set_image:

La filigrana può anche essere inserita utilizzando la classe forma. È molto semplice inserire qualsiasi forma o immagine nell’intestazione o nel piè di pagina e creare così una filigrana di qualsiasi tipo immaginabile.

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

Rimuovi la filigrana da un documento

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

Il seguente esempio di codice mostra come rimuovere una filigrana dai documenti:

Se le filigrane vengono aggiunte utilizzando l’oggetto classe Shape, per rimuovere la filigrana da un documento è necessario impostare solo il nome della forma della filigrana durante l’inserimento e quindi rimuovere la forma della filigrana con un nome assegnato.

Il seguente esempio di codice mostra come impostare il nome della forma della filigrana e rimuoverlo dal documento:

# Set name to be able to remove it afterwards
watermark.name = "WaterMark"

Aggiungi una filigrana nella cella della tabella

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

L’esempio di codice seguente mostra come utilizzare questa proprietà: