使用 Office 加载项

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

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

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

使用任务窗格

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

例如，使用 Aspose.Words API，您可以添加任务窗格加载项并自定义其外观。

使用网络扩展

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-.NET
Document doc = new Document();

TaskPane taskPane = new TaskPane();
doc.WebExtensionTaskPanes.Add(taskPane);

taskPane.DockState = TaskPaneDockState.Right;
taskPane.IsVisible = true;
taskPane.Width = 300;

taskPane.WebExtension.Reference.Id = "wa102923726";
taskPane.WebExtension.Reference.Version = "1.0.0.0";
taskPane.WebExtension.Reference.StoreType = WebExtensionStoreType.OMEX;
taskPane.WebExtension.Reference.Store = "th-TH";
taskPane.WebExtension.Properties.Add(new WebExtensionProperty("mailchimpCampaign", "mailchimpCampaign"));
taskPane.WebExtension.Bindings.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-.NET
doc = new Document(ArtifactsDir + "WorkingWithWebExtension.UsingWebExtensionTaskPanes.docx");
            
Console.WriteLine("Task panes sources:\n");

foreach (TaskPane taskPaneInfo in doc.WebExtensionTaskPanes)
{
    WebExtensionReference reference = taskPaneInfo.WebExtension.Reference;
    Console.WriteLine($"Provider: \"{reference.Store}\", version: \"{reference.Version}\", catalog identifier: \"{reference.Id}\";");
}