Java Word文档段落与文本背景色设置的完全指南

<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>

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.Section;
import com.spire.doc.documents.Paragraph;
import java.awt.*;

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

        Section section = document.getSections().get(0);
        Paragraph paragraph = section.getParagraphs().get(3); // 索引从0开始

        paragraph.getFormat().setBackColor(Color.LIGHT_GRAY);

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

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.documents.TextSelection;
import com.spire.doc.fields.TextRange;
import java.awt.*;

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

        TextSelection[] selections = document.findAllString("目标文本", false, true);

        for (TextSelection selection : selections) {
            TextRange textRange = selection.getAsOneRange();
            textRange.getCharacterFormat().setTextBackgroundColor(Color.CYAN);
        }

        // 若仅修改第一个匹配项：
        // TextRange firstRange = selections[0].getAsOneRange();
        // firstRange.getCharacterFormat().setTextBackgroundColor(Color.CYAN);

        document.saveToFile("文本背景色.docx", FileFormat.Docx_2013);
        document.dispose();
    }
}

import org.apache.poi.xwpf.usermodel.XWPFParagraph;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTShd;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STShd;
public class SetParagraphBackground {
    public static void main(String[] args) {
        // ... 获取 paragraph 对象 ...
        XWPFParagraph paragraph = ...; 
        // 创建并设置段落的背景色
        CTShd cTShd = paragraph.getCTP().addNewPPr().addNewShd();
        cTShd.setFill("FF0000"); // 设置背景色为红色
        cTShd.setVal(STShd.CLEAR); // 设置背景样式为纯色
        // 更新段落的样式（可选，但推荐）
        paragraph.getCTP().getPPr().setShd(cTShd);
    }
}

import org.apache.poi.xwpf.usermodel.XWPFRun;
// ...
XWPFRun run = paragraph.createRun();
run.setText("这是红色文字");
run.setColor("FF0000"); // 设置文字颜色为红色

import com.spire.doc.Document;
import com.spire.doc.Section;
import com.spire.doc.documents.Paragraph;
import java.awt.Color;
public class SetParagraphBackground {
    public static void main(String[] args) {
        // 创建Document对象并加载文档
        Document document = new Document();
        document.loadFromFile("示例.docx");
        // 获取第一个节和其中的段落
        Section section = document.getSections().get(0);
        Paragraph paragraph = section.getParagraphs().get(0);
        // 设置段落的背景颜色为浅灰色[reference:8]
        paragraph.getFormat().setBackColor(Color.LIGHT_GRAY);
        // 保存文档
        document.saveToFile("段落背景色.docx", com.spire.doc.FileFormat.Docx_2013);
        document.dispose();
    }
}

import com.spire.doc.Document;
import com.spire.doc.documents.TextSelection;
import com.spire.doc.fields.TextRange;
import java.awt.Color;
public class SetTextBackground {
    public static void main(String[] args) {
        Document document = new Document();
        document.loadFromFile("示例.docx");
        // 查找文档中所有 "目标文本"
        TextSelection[] selections = document.findAllString("目标文本", true, true);
        for (TextSelection selection : selections) {
            // 将找到的文本范围设置为黄色背景[reference:10]
            TextRange textRange = selection.getAsOneRange();
            textRange.getCharacterFormat().setTextBackgroundColor(Color.YELLOW);
        }
        document.saveToFile("文本背景色.docx", com.spire.doc.FileFormat.Docx_2013);
        document.dispose();
    }
}

import com.aspose.words.Document;
import com.aspose.words.Paragraph;
import java.awt.Color;
public class SetParagraphBackground {
    public static void main(String[] args) throws Exception {
        Document doc = new Document("示例.docx");
        Paragraph para = (Paragraph) doc.getChild(com.aspose.words.NodeType.PARAGRAPH, 0, true);
        // 设置段落背景色
        para.getParagraphFormat().getShading().setBackgroundPatternColor(Color.LIGHT_GRAY);
        doc.save("段落背景色.docx");
    }
}

import com.aspose.words.Document;
import com.aspose.words.Run;
import com.aspose.words.Color;
public class SetTextBackground {
    public static void main(String[] args) throws Exception {
        Document doc = new Document("示例.docx");
        Run run = (Run) doc.getChild(com.aspose.words.NodeType.RUN, 0, true);
        // 设置文本高亮色（背景色）
        run.getFont().setHighlightColor(Color.YELLOW);
        doc.save("文本背景色.docx");
    }
}