使用Office加载项

有时您可能希望授予对运行代码以修改文档的接口控件的访问权限。 Aspose.WordsAPI提供WebExtensions命名空间，该命名空间授予各种类以自定义扩展XML词汇表以表示Office加载项的元素和属性。

WebExtensions命名空间可以有条件地分为:

• 用于使用任务窗格的对象
• 用于使用web扩展的对象

使用任务窗格

任务窗格是在Microsoft Word中显示在窗口右侧的界面表面。 任务窗格允许用户访问可以运行代码来修改文档的界面控件。

例如，使用Aspose.WordsAPI，您可以添加任务窗格外接程序并自定义其外观。

使用Web扩展

Web扩展是扩展Office应用程序功能并与Office文档内容交互的工具。 Web扩展为Office客户端提供了额外的功能，以改善用户体验。

Aspose.Words提供了使用WebExtension和TaskPane类添加任务窗格类型的Web扩展的功能，还允许您自定义窗格和扩展属性。

下面的代码示例演示如何创建任务窗格并添加到具有基本属性的web扩展任务窗格:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
Document doc = new Document();

TaskPane taskPane = new TaskPane();
doc.getWebExtensionTaskPanes().add(taskPane);

taskPane.setDockState(TaskPaneDockState.RIGHT);
taskPane.isVisible(true);
taskPane.setWidth(300);

taskPane.getWebExtension().getReference().setId("wa102923726");
taskPane.getWebExtension().getReference().setVersion("1.0.0.0");
taskPane.getWebExtension().getReference().setStoreType(WebExtensionStoreType.OMEX);
taskPane.getWebExtension().getReference().setStore("th-TH");
taskPane.getWebExtension().getProperties().add(new WebExtensionProperty("mailchimpCampaign", "mailchimpCampaign"));
taskPane.getWebExtension().getBindings().add(new WebExtensionBinding("UnnamedBinding_0_1506535429545", WebExtensionBindingType.TEXT, "194740422"));

doc.save(dataDir + "output.docx", SaveFormat.DOCX);

要查看任务窗格外接程序的列表，请使用WebExtensionTaskPanes属性。

下面的代码示例演示如何获取此类加载项列表:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java
doc = new Document(dataDir + "output.docx");

System.out.println("Task panes sources:");
for (TaskPane taskPaneInfo : doc.getWebExtensionTaskPanes()) {
    WebExtensionReference reference = taskPaneInfo.getWebExtension().getReference();
    System.out.println("Provider: " + reference.getStore() +
            ", version: " + reference.getVersion() +
            ", catalog identifier: " + reference.getId() + ";");
}