使用 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-Python-via-.NET | |
doc = aw.Document() | |
taskPane = aw.webextensions.TaskPane() | |
doc.web_extension_task_panes.add(taskPane) | |
taskPane.dock_state = aw.webextensions.TaskPaneDockState.RIGHT | |
taskPane.is_visible = True | |
taskPane.width = 300 | |
taskPane.web_extension.reference.id = "wa102923726" | |
taskPane.web_extension.reference.version = "1.0.0.0" | |
taskPane.web_extension.reference.store_type = aw.webextensions.WebExtensionStoreType.OMEX | |
taskPane.web_extension.reference.store = "th-TH" | |
taskPane.web_extension.properties.add(aw.webextensions.WebExtensionProperty("mailchimpCampaign", "mailchimpCampaign")) | |
taskPane.web_extension.bindings.add(aw.webextensions.WebExtensionBinding("UnnamedBinding_0_1506535429545", | |
aw.webextensions.WebExtensionBindingType.TEXT, "194740422")) | |
doc.save(docs_base.artifacts_dir + "WorkingWithWebExtension.using_web_extension_task_panes.docx") |
要查看任务窗格加载项的列表,请使用 web_extension_task_panes 属性。
以下代码示例展示了如何获取此类加载项列表:
# For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET | |
doc = aw.Document(docs_base.artifacts_dir + "WorkingWithWebExtension.using_web_extension_task_panes.docx") | |
print("Task panes sources:\n") | |
for taskPaneInfo in doc.web_extension_task_panes : | |
reference = taskPaneInfo.web_extension.reference | |
print(f"Provider: \"{reference.store}\", version: \"{reference.version}\", catalog identifier: \"{reference.id}\"") | |