Trabalhando com marca d'água

Este tópico discute como trabalhar programaticamente com marca d’água usando Aspose.Words. Uma marca d’água é uma imagem de fundo exibida atrás do texto em um documento. Uma marca d’água pode conter um texto ou uma imagem representada pela classe Watermark.

Como adicionar uma marca d’água a um documento

No Microsoft Word, uma marca d’água pode ser facilmente inserida em um documento usando o comando Inserir marca d’água. Aspose.Words fornece a classe Watermark para adicionar ou remover marcas d’água em documentos. Aspose.Words fornece a enumeração WatermarkType que define três tipos possíveis de marcas d’água (TEXT, IMAGE e NONE) para trabalhar

Adicionar marca d’água de texto

O exemplo de código a seguir demonstra como inserir uma marca d’água de texto em um documento definindo TextWatermarkOptions usando o método set_text.

Adicionar marca d’água de imagem

O exemplo de código a seguir demonstra como inserir uma marca d’água de imagem em um documento definindo ImageWatermarkOptions usando o método set_image:

A marca d’água também pode ser inserida usando a classe de forma. É muito fácil inserir qualquer forma ou imagem em um cabeçalho ou rodapé e assim criar uma marca d’água de qualquer tipo imaginável.

O exemplo de código a seguir insere uma marca d’água em um documento do Word:

Remover marca d’água de um documento

A classe Watermark fornece o método remove para remover a marca d’água de um documento.

O exemplo de código a seguir mostra como remover uma marca d’água de documentos:

Se as marcas d’água forem adicionadas usando o objeto de classe Shape, para remover a marca d’água de um documento, você deverá definir apenas o nome do formato da marca d’água durante a inserção e, em seguida, remover o formato da marca d’água por um nome atribuído.

O exemplo de código a seguir mostra como definir o nome da forma da marca d’água e removê-la do documento:

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

Adicionar uma marca d’água na célula da tabela

Às vezes você precisa inserir uma marca d’água/imagem na célula de uma tabela e exibi-la fora da tabela, você pode usar a propriedade is_layout_in_cell. Esta propriedade obtém ou define um sinalizador que indica se a forma é exibida dentro ou fora de uma tabela. Observe que esta propriedade funciona somente quando você otimiza o documento para Microsoft Word 2010 usando o método optimize_for.

O exemplo de código a seguir mostra como usar essa propriedade: