BackgroundShape

DocumentBase.BackgroundShape property

Ottiene o imposta la forma dello sfondo del documento. Può esserenull .

public Shape BackgroundShape { get; set; }

Osservazioni

Microsoft Word consente solo una forma che ha il suoShapeType proprietà equal aRectangle da utilizzare come forma di sfondo per un documento.

Microsoft Word supporta solo le proprietà di riempimento di una forma di sfondo. Tutte le altre proprietà vengono ignorate.

Impostando questa proprietà su un valore non nullo verrà anche impostata laDisplayBackgroundShape AVERO.

Esempi

Mostra come impostare una forma di sfondo per ogni pagina di un documento.

Document doc = new Document();

Assert.IsNull(doc.BackgroundShape);

// L'unico tipo di forma che possiamo usare come sfondo è un rettangolo.
Shape shapeRectangle = new Shape(doc, ShapeType.Rectangle);

// Esistono due modi per utilizzare questa forma come sfondo di una pagina.
// 1 - Un colore piatto:
shapeRectangle.FillColor = System.Drawing.Color.LightBlue;
doc.BackgroundShape = shapeRectangle;

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

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

// Regola l'aspetto dell'immagine per renderla più adatta come filigrana.
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 non supporta forme con immagini come sfondi,
// ma possiamo comunque vedere questi sfondi in altri formati di salvataggio come .pdf.
doc.Save(ArtifactsDir + "DocumentBase.BackgroundShape.Image.pdf", saveOptions);

Guarda anche

DocumentBase.Document