无法使用office.js在word文档的书签中插入文本进行office插件开发

Question

我正在为 word 开发一个插件。主要任务是用数据库中的数据填充文档中的书签。在 office.js 中，我发现书签可以作为范围对象访问，我我正在使用“rangeObject.insertText(text, insertLocation)”方法将数据插入书签。但问题是第二个参数 insertLocation 值可以是“替换”、“开始”、“结束”、“之前”或“之后”。它基本上在书签之前或之后附加数据。像这样 - image 1 (current result using insertLocation value 'End')

使用 insertLocation 值“替换”它会替换整个书签并实际上从文档中删除书签！所以我想要的只是在书签中插入一个文本，如下所示 - image 2 (desired result)

注意：我必须稍后阅读这些书签值。所以不能删除任何书签。我正在使用 office.js api 的 1.4 beta 版本。

这是我的代码-

        Word.run(function (context) {

            var doc = context.document;

            //get the bookmark range by its name
            var bookmarkRange = doc.getBookmarkRangeOrNullObject("cscasenumber01");

            //insert a data
            bookmarkRange.insertText("test data",'end');


            // Synchronize the document state by executing the queued commands, 
            return context.sync();

        }).catch(errorHandler);

Answer 1

查看此问题后，我们发现“替换”行为是设计使然。

实际上，如果您直接使用 UI 替换包含书签的范围的文本，则该书签将被删除。如果您使用宏/VBA 以编程方式执行此操作，情况也是如此。

好消息是，替换文本后，选择将是被替换的文本范围，因此如果需要，您可以在替换操作后重新创建书签。

请注意，这只发生在替换时。在开始或结束时插入将保留书签。

最后，Bookmark API 仍处于预览阶段，发布日期未知。

--------- 保留预览答案的一些上下文 ---------

非常感谢您使用我们的预览版 API。我只是重现这种行为，它是设计使然。是的，API 上的 before、start、end、after 的语义非常清晰。

1. “开始”和“结束”插入位置意味着插入将在调用 Range 的边界内，在这种情况下意味着如果您使用其中任何一个，则需要将书签扩展为插入的任何内容。李>
2. 另一方面，“之前”/“之后”意味着插入范围边界之外。
3. 最后，replace 应该用作为参数提供的任何文本替换书签，书签将被删除（与直接在 UI 中执行此操作和使用 VBA 以编程方式执行此操作一致）。

谢谢