The default background of a Word document is white, and in the vast majority of cases, a simple white background is sufficient. However, if you are creating a resume, a broacher or other creative document that needs to be eye-catching, setting a unique background color or image may also be essential. This article will demonstrate how to programmatically add a background color or image to a Word document using Spire.Doc for .NET.
- Add a Background Color to a Word Document
- Add a Gradient Background to a Word Document
- Insert a Background Image to a Word Document
Install Spire.Doc for .NET
To begin with, you need to add the DLL files included in the Spire.Doc for.NET package as references in your .NET project. The DLL files can be either downloaded from this link or installed via NuGet.
PM> Install-Package Spire.Doc
Add a Background Color to a Word Document
Adding a background color to a Word document is quite simple. You just need to set the background type as color and then choose a color as the background. The detailed steps are as follows.
- Create a Document instance.
- Load a sample Word document using Document.LoadFromFile() method.
- Set the background type as color using Document.Background.Type property.
- Set a background color for the document using Document.Background.Color property.
- Save the result document using Document.SaveToFile() method.
- C#
- VB.NET
using Spire.Doc; using System.Drawing; using Spire.Doc.Documents; namespace ConvertWordToPng { class Program { static void Main(string[] args) { //Create a Document instance Document document = new Document(); //Load a sample Word document document.LoadFromFile("Test.docx"); //Set the background type as color document.Background.Type = BackgroundType.Color; //Set the background color document.Background.Color = Color.AliceBlue; //Save the document document.SaveToFile("PureColorBackground.docx", FileFormat.Docx); } } }
Add a Gradient Background to a Word Document
Adding gradient background requires more steps. You need to set the background type as gradient, choose two colors, and then set shading variant and style. The detailed steps are as follows.
- Create a Document instance.
- Load a sample Word document using Document.LoadFromFile() method.
- Set the background type as gradient using Document.Background.Type property.
- Get the background gradient using Document.Background.Gradient property.
- Select two colors using BackgroundGradient.Color1 and BackgroundGradient.Color2 properties.
- Set shading variant and style for the gradient using BackgroundGradient.ShadingVariant and BackgroundGradient. ShadingStyle properties.
- Save the result document using Document.SaveToFile() method.
- C#
- VB.NET
using Spire.Doc; using System.Drawing; using Spire.Doc.Documents; namespace ConvertWordToPng { class Program { static void Main(string[] args) { //Create a Document instance Document document = new Document(); //Load a sample Word document document.LoadFromFile("Test.docx"); //Set the background type as gradient document.Background.Type = BackgroundType.Gradient; //Get the background gradient BackgroundGradient gradient = document.Background.Gradient; //Select two colors gradient.Color1 = Color.White; gradient.Color2 = Color.LightBlue; //Set shading variant and style for the gradient gradient.ShadingVariant = GradientShadingVariant.ShadingDown; gradient.ShadingStyle = GradientShadingStyle.Horizontal; //Save the document document.SaveToFile("AddGradientBackground.docx", FileFormat.Docx); } } }
Insert a Background Image to a Word Document
To insert a background image to a Word document, you need to set the background type as picture, and then insert a picture as the background. The detailed steps are as follows.
- Create a Document instance.
- Load a sample Word document using Document.LoadFromFile() method.
- Set the background type as picture using Document.Background.Type property.
- Set a background picture for the document using Document.Background.Picture property.
- Save the result document using Document.SaveToFile() method.
- C#
- VB.NET
using Spire.Doc; using Spire.Doc.Documents; using System.Drawing; namespace SetImageBackground { class Program { static void Main(string[] args) { { //Create a Document instance Document document = new Document(); //Load a sample Word document document.LoadFromFile("Test.docx"); //Set the background type as picture document.Background.Type = BackgroundType.Picture; //Set background picture document.Background.Picture = Image.FromFile("background.jpg"); //Save the document document.SaveToFile("AddBackgroundPicture.docx", FileFormat.Docx); } } } }
Apply for a Temporary License
If you'd like to remove the evaluation message from the generated documents, or to get rid of the function limitations, please request a 30-day trial license for yourself.