BackgroundShape

DocumentBase.BackgroundShape property

Obtient ou définit la forme d’arrière-plan du document. Peut êtrenul .

public Shape BackgroundShape { get; set; }

Remarques

Microsoft Word autorise uniquement une forme qui a sonShapeType propriété égale àRectangle à utiliser comme forme d’arrière-plan pour un document.

Microsoft Word prend en charge uniquement les propriétés de remplissage d’une forme d’arrière-plan. Toutes les autres propriétés sont ignorées.

La définition de cette propriété sur une valeur non nulle définira également leDisplayBackgroundShape àvrai.

Exemples

Montre comment définir une forme d’arrière-plan pour chaque page d’un document.

Document doc = new Document();

Assert.IsNull(doc.BackgroundShape);

// Le seul type de forme que nous pouvons utiliser comme arrière-plan est un rectangle.
Shape shapeRectangle = new Shape(doc, ShapeType.Rectangle);

// Il existe deux manières d'utiliser cette forme comme arrière-plan de page.
// 1 - Un aplat de couleur :
shapeRectangle.FillColor = System.Drawing.Color.LightBlue;
doc.BackgroundShape = shapeRectangle;

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

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

// Ajuste l'apparence de l'image pour la rendre plus adaptée comme filigrane.
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 ne prend pas en charge les formes avec des images en arrière-plan,
// mais nous pouvons toujours voir ces arrière-plans dans d'autres formats de sauvegarde tels que .pdf.
doc.Save(ArtifactsDir + "DocumentBase.BackgroundShape.Image.pdf", saveOptions);

Voir également

DocumentBase.Document