Word加载项中的绑定用法-Java 学习之路

我想使用Office Add-in技术为Word文档提供模型 - 视图 - 控制器逻辑 .

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

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

1 回答

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

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

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

另外register for two event handlers以便在用户选择或修改这些内容控件中的文本时收到通知 . 本案中的相关事件分别为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，办公室加载项的PM

回复于 2024-04-28T13:35:26+08:00

Word加载项中的绑定用法

1 回答

相关问题