如何在 Java 中为 word 文档（.doc 或 .docx）设置背景颜色（页面颜色）？

Question

通过像 http://poi.apache.org 这样的一些库，我们可以创建具有任何文本颜色的 word 文档，但是对于文本的 background 或突出显示，我没有找到任何解决方案。

以手动方式为单词的页面颜色！：

https://support.office.com/en-us/article/Change-the-background-or-color-of-a-document-6ce0b23e-b833-4421-b8c3-b3d637e62524

这是我通过 poi.apache 创建 word 文档的主要代码

        // Blank Document
        @SuppressWarnings("resource")
        XWPFDocument document = new XWPFDocument();
        // Write the Document in file system
        FileOutputStream out = new FileOutputStream(new File(file_address));
        // create Paragraph
        XWPFParagraph paragraph = document.createParagraph();
        paragraph.setAlignment(ParagraphAlignment.RIGHT);

        XWPFRun run = paragraph.createRun();
        run.setFontFamily(font_name);
        run.setFontSize(font_size);
        // This only set text color not background!
        run.setColor(hex_color);

        for (String s : text_array) {
            run.setText(s);
            run.addCarriageReturn();
        }

        document.write(out);
        out.close();

Answer 1

我们只需要添加这 3 行来为 XWPF 设置 Word 文档的背景颜色。我们必须在声明 XWPFRun 和它的文本颜色后设置这些行：

CTShd cTShd = run.getCTR().addNewRPr().addNewShd();
cTShd.setVal(STShd.CLEAR);
cTShd.setFill(hex_background_color);

Answer 2

更新：XWPF 是创建 word 文档文件的最新方式，但设置背景只能通过 HWPF 进行，它适用于旧格式版本 (.doc)

对于 *.doc（即 POI 的 HWPF 组件）：

1. 突出显示文本： 查看setHighlighted()

2. 背景颜色：

   我想你是指段落的背景（AFAIK，Word 也允许为整个页面着色，这是另一回事）

   setShading() 允许您为段落提供前景色和背景色（通过setCvFore() 和setCvBack() 或SHDAbstractType）。 IIRC，它是您想要设置的 foreground 以便为您的段落着色。 背景仅与由两种（交替）颜色组成的阴影相关。

   底层数据结构被命名为Shd80 ([MS-DOC], 2.9.248)。还有SHDOperand ([MS-DOC], 2.9.249) 反映了 Word97 之前 Word 的功能。 [MS-DOC] 是二进制 Word 文件格式规范，可在 MSDN 上免费获取。

编辑：

这里有一些代码来说明上述情况：

    try {
        HWPFDocument document = [...]; // comes from somewhere
        Range range = document.getRange();

        // Background shading of a paragraph
        ParagraphProperties pprops = new ParagraphProperties();
        ShadingDescriptor shd = new ShadingDescriptor();
        shd.setCvFore(Colorref.valueOfIco(0x07)); // yellow; ICO
        shd.setIpat(0x0001); // solid background; IPAT
        pprops.setShading(shd);
        Paragraph p1 = range.insertBefore(pprops, StyleSheet.NIL_STYLE);
        p1.insertBefore("shaded paragraph");

        // Highlighting of individual characters
        Paragraph p2 = range.insertBefore(new ParagraphProperties(), StyleSheet.NIL_STYLE);     
        CharacterRun cr = p2.insertBefore("highlighted text\r");
        cr.setHighlighted((byte) 0x06); // red; ICO

        document.write([...]); // document goes to somewhere
    } catch (IOException e) {   
        e.printStackTrace();
    }

• ICO 是一个颜色结构
• IPAT 是预定义的着色样式列表