如何在 Word 书签位置插入文本、图片和表格（Java 示例）

在Word书签位置插入内容

在现代企业的办公自动化和报表生成中，Word 文档常被用于展示业务分析结果、统计数据以及可视化内容。对于开发者而言，如果能够在文档的指定位置自动插入文本、图片和表格，不仅能够显著提升工作效率，还能确保文档内容的规范化和模板的可重复利用。

Word 书签是一种高效的定位工具。通过在文档中预先设置书签，我们可以将特定位置标记出来，程序在处理时能够直接跳转到这些位置，而无需依赖复杂的段落索引或关键字搜索。本文将结合 Spire.Doc forJava 库，演示如何在 Word 书签位置插入文本、图片和表格 ，帮助开发者快速实现自动化文档生成。

文章目录：

Spire.Doc for Java 简介与安装
在 Word书签位置插入文本
在 Word 书签位置插入图片
在 Word 书签位置插入表格
总结
常见问题解答

Spire.Doc for Java 简介与安装

Spire.Doc for Java 是一款专业的 Java Word 组件，使开发人员能够在不安装 Microsoft Office 的情况下，轻松地创建、读取、写入、转换和打印 Word 文档。它提供了丰富的 API，支持处理文档中的文本、图片、表格、图表、形状、水印等多种元素。

Spire.Doc for Java 的主要特性包括：

完整的 Word 文档操作功能（创建、编辑、转换和打印）
高性能的文档处理能力
支持 DOC、DOCX、WordML、RTF、HTML 等格式
不依赖 Microsoft Office
适用于 Windows、Linux 和 Mac 操作系统

安装方法

要在Java项目中使用Spire.Doc for Java，可以通过以下两种方式添加依赖：

Maven 项目：

在pom.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>13.8.7</version>
    </dependency>
</dependencies>

手动导入 JAR ：

从官网下载 Spire.Doc for Java 包。
将下载的JAR文件添加到项目的构建路径中。

完成依赖配置后，就可以在 Java 代码中导入相关类并开始使用 Spire.Doc for Java 的功能了。

Java 在 Word书签位置插入文本

在 Word 模板中添加书签（如<span lang="EN-US">TextBookmark</span>）后，我们可以通过 Spire.Doc 的<span lang="EN-US">BookmarksNavigator</span>定位到书签，并插入文本内容。下面是一个完整的示例：

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.documents.BookmarksNavigator;

public class AddTextToBookmark {

    public static void main(String[] args) {

        // 加载包含书签的文档
        Document doc = new Document();
        doc.loadFromFile("C:\\Users\\Administrator\\Desktop\\Template.docx");

        // 定位到指定书签位置
        BookmarksNavigator bookmarksNavigator = new BookmarksNavigator(doc);
        bookmarksNavigator.moveToBookmark("TextBookmark");

        // 在书签位置插入文本
        String text = "本月，公司整体销售额达到了 1,250,000 元，比上月增长 12%。 其中，电子产品类增长最快，同比增长 18%；而服装类保持稳定。整体客户满意度评分为 4.6（满分 5 分），用户反馈较为积极。";
        bookmarksNavigator.insertText(text);

        //保存文档
        doc.saveToFile("添加文本到书签.docx", FileFormat.Docx_2013);
        doc.dispose();
    }
}

代码解析

使用 Document 类的 loadFromFile 方法加载包含书签的 Word 模板文档。
创建 BookmarksNavigator 对象，并调用 moveToBookmark 方法定位到特定书签。
使用 insertText 方法在书签位置插入指定的文本内容。
使用 saveToFile 方法保存修改后的文档。

效果图：

在Word书签位置插入文本

注：插入的文本将沿用书签所在段落的字体样式。如须对插入的文本设置不同的样式，则需要创建 Paragraph 对象，添加文本并设置格式。然后通过 BookmarksNavigator.insertParagraph 方法将段落添加到书签位置。

Java 在 Word 书签位置插入图片

在报表或模板文档中，图片通常用于数据可视化。通过书签定位后，我们可以将柱状图、折线图或任意图片插入到文档中。以下是如何在书签位置插入图片的示例代码：

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.documents.BookmarksNavigator;
import com.spire.doc.documents.Paragraph;

public class AddImageToBookmark {

    public static void main(String[] args) {

        // 加载包含书签的文档
        Document doc = new Document();
        doc.loadFromFile("C:\\Users\\Administrator\\Desktop\\Template.docx");

        // 定位到指定书签位置
        BookmarksNavigator bookmarksNavigator = new BookmarksNavigator(doc);
        bookmarksNavigator.moveToBookmark("ImageBookmark");

        // 在书签位置插入图片
        Paragraph paragraph = new Paragraph(doc);
        paragraph.appendPicture("C:\\Users\\Administrator\\Desktop\\chart_img.png");
        bookmarksNavigator.insertParagraph(paragraph);
        
        //保存文档
        doc.saveToFile("添加图片到书签.docx", FileFormat.Docx_2013);
        doc.dispose();
    }
}

代码解析：

加载包含书签的 Word 模板文档。
创建 Paragraph 对象，并使用 appendPicture 方法将指定路径的图片添加到段落中。
创建 BookmarksNavigator 对象，并调用 moveToBookmark 方法定位到特定书签。
使用 insertParagraph 方法将包含图片的段落插入到书签位置。
保存更新后的文档。

高级图片设置技巧：

可以通过 DocPicture 对象 (由 appendPicture 方法返回) 调整插入图片的尺寸和设置文字环绕图片的方式。
可以使用 Paragraph 的格式化方法设置图片在段落中的对齐方式。

效果图：

在Word书签位置插入图片

Java 在 Word 书签位置插入表格

表格是 Word 文档中组织数据的重要方式。使用 Spire.Doc for Java，我们可以在书签位置动态插入表格，并填充数据，这对于生成数据报告和统计表格特别有用。

import com.spire.doc.Document;
import com.spire.doc.FileFormat;
import com.spire.doc.Table;
import com.spire.doc.TableRow;
import com.spire.doc.documents.BookmarksNavigator;

public class AddTableToBookmark {

    public static void main(String[] args) {

        // 加载包含书签的文档
        Document doc = new Document();
        doc.loadFromFile("C:\\Users\\Administrator\\Desktop\\Template.docx");

        // 定位到指定书签位置
        BookmarksNavigator bookmarksNavigator = new BookmarksNavigator(doc);
        bookmarksNavigator.moveToBookmark("TableBookmark");

        // 创建一个表格
        String[][] data = {
                new String[]{"指标", "数值", "说明"},
                new String[]{"总销售额", "1,250,000 元", "本月公司整体销售额"},
                new String[]{"销售增长率", "+12%", "相比上月"},
                new String[]{"电子产品增长率", "+18%", "增长最快的品类"},
                new String[]{"服装类增长率", "稳定", "无明显增长或下降"},
        };
        Table table = new Table(doc, true);
        table.resetCells(data.length, data[0].length);
        for (int i = 0; i < data.length; i++) {
            TableRow dataRow = table.getRows().get(i);
            for (int j = 0; j < data[i].length; j++) {
                dataRow.getCells().get(j).addParagraph().appendText(data[i][j]);
            }
        }

        // 在书签位置插入表格
        bookmarksNavigator.insertTable(table);

        //保存文档
        doc.saveToFile("添加表格到书签.docx", FileFormat.Docx_2013);
        doc.dispose();
    }
}

代码解析：

加载包含书签的 Word 模板文档。
创建 Table 对象，并将数据填充至表格。
创建 BookmarksNavigator 对象，并调用 moveToBookmark 方法定位到特定书签。
使用 insertTable 方法将表格添加到书签位置。
保存更新后的文档。

效果图：

在Word书签位置插入表格

Spire.Doc 支持多样化的表格样式设置，例如：单元格合并与拆分、背景色设置、文本对齐方式等。更多详情，请参考：Java 创建 Word 表格

总结

通过本文的介绍，我们学习了如何利用 Spire.Doc for Java 在 Word 文档的书签位置插入文本、图片和表格。无论是生成业务报表、插入可视化图表，还是填充结构化数据，书签功能都能够帮助开发者快速、精准地定位目标位置，从而实现高度自动化的文档处理流程。

借助 Spire.Doc for Java 提供的强大 API，开发者不仅可以提升办公文档生成的效率，还能够确保输出结果的规范性与一致性。这种方式大大减少了手工操作的重复劳动，使 Word 文档能够真正成为数据驱动型应用中的动态展示载体，为企业信息化和自动化办公提供了可靠支持。

常见问题解答

Q1. 如何确保书签存在于文档中？

可以使用 Document.getBookmarks() 方法获取文档中的所有书签，然后遍历书签集合找到需要的书签。

Q2. 插入内容后，书签会保留吗？

会，插入的内容不会影响原有书签。如需移除书签，可以使用 doc.getBookmarks().remove() 或者 doc.getBookmarks().removeAt() 方法。

Q3. 可以设置插入内容的格式（字体、颜色、大小等）吗？

可以。格式化的文本内容需要通过 Paragraph 的形式添加到书签处，表格的样式则可以通过 Table 对象下的方法进行设置。

Q4. Spire.Doc for Java 是否支持其他文件格式？

是的，Spire.Doc 支持多种文件格式，比如 DOCX、DOC、PDF 等，您可以根据需求选择合适的格式进行读取和保存。

申请临时License

如果您需要去除生成文档中的评估提示或解除功能限制，请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。