3

我想使用 Office 插件技术为 Word 文档提供模型-视图-控制器逻辑。

在我的场景中，用户应该能够创建一个新的 Word 文档，激活加载项并按下加载项内的按钮以将文本框字段添加到文档。该字段应显示来自数据库的数字：当用户更新该数字并按保存时，该数字应写回数据库。下次打开 Word 文档时，应刷新数字，以显示更新的值。

我想知道的是插件技术是否可以使用（可能有绑定支持？）还是仍处于试验阶段。我在尝试理解构建仅代表我的文本框的紧凑 OOXML 的最佳方法时遇到了麻烦：getSelectedDataAsync 方法输出一个非常复杂的文档，它不能是描述单灯基本差的更聪明的方法-裸文本框字段！以及如何将绑定设置为自定义 XML？该 XML 应该放在哪里？文件里面？我查看了 Microsoft 在 GitHub 上提供的示例，但它们不是很清楚，因为在许多情况下它们基于现有的 Word 文档，这些文档已经具有必要的数据和字段。

4

1 回答 1

2

确实！您描述的场景实际上是该平台最初设计的主要插件类型之一。关键元素是一个 JavaScript 对象，我们称之为“绑定”，它跟踪文档中的内容控件，并且不需要 OXML 或自定义 XML。

API 能够直接添加内容控件（类似于文本框）：调用Bindings.addFromSelectionAsync方法。

function addNewField(fieldName){
    Office.context.document.bindings.addFromSelectionAsync("text",
    { id: fieldName },
    function (asyncResult){
        displayNumberFromDatabase(asyncResult.value);
    }
}

还要注册两个事件处理程序，以便在用户选择或修改这些内容控件中的文本时收到通知。这种情况下的相关事件分别是BindingSelectionChanged和BindingDataChanged。

Office.context.document.addHandlerAsync("bindingDataChanged", whenBindingDataChanged);
Office.context.document.addHandlerAsync("bindingSelectionChanged", whenBindingSelected);

当这些事件被触发时，你会想要阅读内容。您可以使用Binding.getDataAsync方法来做到这一点。

function whenBindingDataChanged(eventArgs){
    eventArgs.binding.getDataAsync(function(asyncResult){
        setValueToDatabaseAsync(eventArgs.binding.id,asyncResult.value);
        // you need to implement setValueToDatabaseAsync
    });
}

最后，要自己修改Binding的内容，写入初始值，使用Binding.setDataAsync方法。

function displayNumberFromDatabase(myBinding){
    getValueFromDatabaseAsync(myBinding.id, function(value){
        myBinding.setDataAsync(value);
    });
    // you need to implement getValueFromDatabaseAsync
}

-Michael Saunders，Office 插件的 PM

于 2016-08-24T17:20:40.463 回答