Java 操作 Word 文档：添加背景颜色与背景图片

在文档编排过程中，页面背景的适当运用能有效提升视觉层次感。对于宣传册、邀请函或营销材料等场景，纯白背景有时显得过于单调。本文介绍如何通过 Java 代码为 Word 文档设置纯色、渐变背景以及图片背景，并附带段落背景色的补充用法。

本文使用的工具是一个用于操作 Word 文档的 Java 组件，支持在不安装 Microsoft Office 环境的条件下完成文档的创建、编辑与转换。

环境准备

在项目的 pom.xml 中添加如下依赖：

xml 复制代码

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.cn/repository/maven-public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.doc</artifactId>
        <version>14.6.0</version>
    </dependency>
</dependencies>

设置纯色背景

设置纯色背景需要先将背景类型指定为颜色，再设定具体的 Color 对象。

java 复制代码

import com.spire.doc.*;
import com.spire.doc.documents.BackgroundType;
import java.awt.*;

public class AddBackgroundColor {
    public static void main(String[] args) throws Exception {
        // 加载文档
        Document document = new Document();
        document.loadFromFile("示例.docx");

        // 设置背景类型为颜色，并指定颜色值
        document.getBackground().setType(BackgroundType.Color);
        document.getBackground().setColor(Color.ORANGE);

        // 保存文档
        document.saveToFile("添加背景颜色.docx", FileFormat.Docx);
    }
}

设置渐变背景

渐变背景能提供比纯色更丰富的视觉效果。除了设定两种渐变颜色外，还可以通过 setShadingStyle 和 setShadingVariant 控制渐变的方向与变形样式。

java 复制代码

import com.spire.doc.*;
import com.spire.doc.documents.BackgroundType;
import com.spire.doc.documents.GradientShadingStyle;
import com.spire.doc.documents.GradientShadingVariant;
import java.awt.*;

public class AddGradientBackground {
    public static void main(String[] args) throws Exception {
        Document document = new Document();
        document.loadFromFile("示例.docx");

        // 设置背景类型为渐变
        document.getBackground().setType(BackgroundType.Gradient);
        Background background = document.getBackground();

        // 设定两种渐变颜色
        background.getGradient().setColor1(Color.WHITE);
        background.getGradient().setColor2(Color.ORANGE);

        // 设定渐变样式与变形方向
        background.getGradient().setShadingStyle(GradientShadingStyle.Horizontal);
        background.getGradient().setShadingVariant(GradientShadingVariant.Shading_Down);

        document.saveToFile("添加渐变背景.docx", FileFormat.Docx_2013);
    }
}

设置图片背景

将图片设置为文档背景时，需将 BackgroundType 设为 Picture，再通过 setPicture 方法传入图片路径。

java 复制代码

import com.spire.doc.*;
import com.spire.doc.documents.BackgroundType;

public class AddPictureBackground {
    public static void main(String[] args) throws Exception {
        Document document = new Document();
        document.loadFromFile("示例.docx");

        // 设置背景类型为图片，并指定图片路径
        document.getBackground().setType(BackgroundType.Picture);
        document.getBackground().setPicture("背景.jpg");

        document.saveToFile("添加背景图片.docx", FileFormat.Docx);
    }
}

补充：段落与文本的背景色

除了页面背景，该组件也支持对特定段落设置背景色（相当于高亮效果）。以下示例演示如何将第一个段落的背景设为浅灰色：

java 复制代码

import com.spire.doc.*;
import java.awt.*;

public class SetParagraphBackground {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("示例.docx");

        // 获取第一个段落并设置背景色
        Paragraph paragraph = document.getSections().get(0).getParagraphs().get(0);
        paragraph.getFormat().setBackColor(Color.LIGHT_GRAY);

        document.saveToFile("段落背景色.docx", FileFormat.Docx_2013);
    }
}

小结

以上代码演示了通过 Java 设置三种不同的 Word 页面背景：纯色背景适用于需要简洁统一色调的场景，渐变背景在封面或标题页中能增强视觉层次，图片背景则适合品牌宣传或个性化文档设计。段落背景色作为一种补充手段，可用于强调特定内容区块。这些方法在批量生成报告、自动化处理文档模板等开发任务中具有一定实用价值，能够减少重复性的手动操作，提升文档产出的效率。