Java 给Word文档添加背景颜色

前言

当我们制作好Word文档后，想要让枯燥乏味的文本显得有活力，或是想高亮显示文档中指定的段落或文字，此时我们可以通过为整个文档或某特定文字/段落添加背景色的形式来实现。本文将使用Free Spire.Doc for Java控件来演示如何在Java程序中给Word文档添加背景颜色。

本文代码演示内容可分为：

• 给整个Word文档添加背景颜色

1）添加纯色背景色

2）添加渐变色背景色

• 给Word文档中的指定段落或文字添加背景色

测试环境

在运行代码前，需要搭建测试环境。首先下载安装配置好JDK和IntelliJ IDEA, 然后将Free Spire.Doc for Java控件里的Jar包导入IDEA。这里重点讲解下如何导入Jar包。导入方式一共有两种：其一，在官网上下载产品包，解压后将lib文件夹下的Spire.Doc.jar手动导入IDEA；其二（推荐使用），在IDEA中创建一个Maven项目，然后在pom.xml文件中键入以下代码，最后点击“Import Changes”即可。

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

最终导入效果如下图所示：

代码演示

示例1 给整个Word文档添加背景颜色

1）添加纯色背景色

import com.spire.doc.*;
import com.spire.doc.documents.BackgroundType;
import java.awt.*;
public class SolidBackgroundColor {
    public static void main(String[] args) {
        //加载Word示例文档
 Document document= new Document("C:UsersTest1DesktopSample.docx");
        //添加背景颜色并设置颜色类型
 document.getBackground().setType(BackgroundType.Color);
        document.getBackground().setColor(Color.lightGray);
        //保存结果文档
 document.saveToFile("output/AddSolidColor.docx", FileFormat.Docx);
    }
}

效果图：

2）添加渐变色背景色

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 GradientBackgroundColor {
    public static void main(String[] args) {
        //加载Word示例文档
 Document document= new Document("C:UsersTest1DesktopSample.docx");
        //添加背景颜色并设置颜色类型
 document.getBackground().setType(BackgroundType.Gradient);
        document.getBackground().getGradient().setColor1(Color.white);
        document.getBackground().getGradient().setColor2(Color.cyan);
        document.getBackground().getGradient().setShadingVariant(GradientShadingVariant.Shading_Down);
        document.getBackground().getGradient().setShadingStyle(GradientShadingStyle.Horizontal);
        //保存结果文档
 document.saveToFile("output/AddGradientColor.docx", FileFormat.Docx_2013);
    }
}

效果图：

示例2 给文档中的指定段落或文字添加背景色

import com.spire.doc.*;
import com.spire.doc.documents.*;
import com.spire.doc.fields.*;
import java.awt.*;
public class SetParagraphShading {
    public static void main(String[] args) {
        //加载Word示例文档
 Document document = new Document();
        document.loadFromFile("C:UsersTest1DesktopSample.docx");
        //获取文档中的指定段落
 Paragraph paragaph = document.getSections().get(0).getParagraphs().get(3);
        //给指定段落添加背景色
 paragaph.getFormat().setBackColor(Color.yellow);
        //获取文档中的指定文本
 paragaph = document.getSections().get(0).getParagraphs().get(1);
        TextSelection selection = paragaph.find("圣诞节", true, false);
        //给指定文本添加背景色
 TextRange range = selection.getAsOneRange();
        range.getCharacterFormat().setTextBackgroundColor(Color.pink);
        //保存结果文档
 document.saveToFile("output/AddParagraphShading.docx", FileFormat.Docx_2013);
    }
}

效果图：