BackgroundShape

DocumentBase.BackgroundShape property

Obtiene o establece la forma del fondo del documento. Puede sernulo .

public Shape BackgroundShape { get; set; }

Observaciones

Microsoft Word sólo permite una forma que tenga suShapeType propiedad igual aRectangle para ser utilizado como forma de fondo para un documento.

Microsoft Word sólo admite las propiedades de relleno de una forma de fondo. Todas las demás propiedades se ignoran.

Establecer esta propiedad en un valor no nulo también establecerá elDisplayBackgroundShape averdadero.

Ejemplos

Muestra cómo establecer una forma de fondo para cada página de un documento.

Document doc = new Document();

Assert.IsNull(doc.BackgroundShape);

// El único tipo de forma que podemos usar como fondo es un rectángulo.
Shape shapeRectangle = new Shape(doc, ShapeType.Rectangle);

// Hay dos formas de utilizar esta forma como fondo de página.
// 1 - Un color plano:
shapeRectangle.FillColor = System.Drawing.Color.LightBlue;
doc.BackgroundShape = shapeRectangle;

doc.Save(ArtifactsDir + "DocumentBase.BackgroundShape.FlatColor.docx");

// 2 - Una imagen:
shapeRectangle = new Shape(doc, ShapeType.Rectangle);
shapeRectangle.ImageData.SetImage(ImageDir + "Transparent background logo.png");

// Ajusta la apariencia de la imagen para que sea más adecuada como marca de agua.
shapeRectangle.ImageData.Contrast = 0.2;
shapeRectangle.ImageData.Brightness = 0.7;

doc.BackgroundShape = shapeRectangle;

Assert.IsTrue(doc.BackgroundShape.HasImage);

Aspose.Words.Saving.PdfSaveOptions saveOptions = new Aspose.Words.Saving.PdfSaveOptions
{
    CacheBackgroundGraphics = false
};

// Microsoft Word no admite formas con imágenes como fondo,
// pero aún podemos ver estos fondos en otros formatos de guardado como .pdf.
doc.Save(ArtifactsDir + "DocumentBase.BackgroundShape.Image.pdf", saveOptions);

Ver también

DocumentBase.Document