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.

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 Tipo de marca d’águaenumeração que define três tipos possíveis de marcas d’água (Texto, Imagem e Nenhuma) 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 SetText:

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 SetImage:

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 em uma célula de 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 IsLayoutInCell. 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 OptimizeFor.

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