Trabajar con marca de agua

Este tema analiza cómo trabajar mediante programación con marcas de agua usando Aspose.Words. Una marca de agua es una imagen de fondo que se muestra detrás del texto en un documento. Una marca de agua puede contener un texto o una imagen representada por la clase Watermark.

Cómo agregar una marca de agua a un documento

En Microsoft Word, se puede insertar fácilmente una marca de agua en un documento usando el comando Insertar marca de agua. Aspose.Words proporciona la clase Watermark para agregar o eliminar marcas de agua en documentos. Aspose.Words proporciona la enumeración WatermarkType que define tres tipos posibles de marcas de agua (TEXT, IMAGE y NONE) con las que trabajar.

Agregar marca de agua de texto

El siguiente ejemplo de código demuestra cómo insertar una marca de agua de texto en un documento definiendo TextWatermarkOptions mediante el método set_text.

Agregar marca de agua de imagen

El siguiente ejemplo de código demuestra cómo insertar una marca de agua de imagen en un documento definiendo ImageWatermarkOptions usando el método set_image:

La marca de agua también se puede insertar utilizando la clase de forma. Es muy fácil insertar cualquier forma o imagen en un encabezado o pie de página y así crear una marca de agua de cualquier tipo imaginable.

El siguiente ejemplo de código inserta una marca de agua en un documento de Word:

Eliminar marca de agua de un documento

La clase Watermark proporciona el método de eliminación para eliminar la marca de agua de un documento.

El siguiente ejemplo de código muestra cómo eliminar una marca de agua de los documentos:

Si las marcas de agua se agregan utilizando el objeto de clase Shape, para eliminar la marca de agua de un documento, debe establecer solo el nombre de la forma de la marca de agua durante la inserción y luego eliminar la forma de la marca de agua mediante un nombre asignado.

El siguiente ejemplo de código le muestra cómo establecer el nombre de la forma de la marca de agua y eliminarla del documento:

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

Agregar una marca de agua en la celda de la tabla

A veces es necesario insertar una marca de agua/imagen en la celda de una tabla y mostrarla fuera de la tabla; puede usar la propiedad is_layout_in_cell. Esta propiedad obtiene o establece una bandera que indica si la forma se muestra dentro o fuera de una tabla. Tenga en cuenta que esta propiedad solo funciona cuando optimiza el documento para Microsoft Word 2010 utilizando el método optimize_for.

El siguiente ejemplo de código muestra cómo utilizar esta propiedad: