Работа с надстройками Office

Иногда может потребоваться предоставить доступ к элементам управления интерфейса, которые запускают код для изменения документов. Aspose.Words API предоставляет модуль webextensions, который предоставляет различные классы для настройки элементов и атрибутов, расширяя словарь XML для представления надстроек Office.

WebExtensions пространство имен может быть условно разделено на:

• Объекты для работы с панелью задач
• Объекты для работы с веб-расширениями

Использование панелей задач

Панели задач - это интерфейсные поверхности, которые отображаются в правой части окна в Microsoft Word. Панель задач позволяет пользователям получать доступ к элементам управления интерфейса, которые могут запускать код для изменения документов.

Например, используя Aspose.Words API, вы можете добавить надстройку панели задач и настроить ее внешний вид.

Использование веб-расширений

Веб-расширения - это инструменты, расширяющие возможности приложений Office и позволяющие взаимодействовать с содержимым документов Office. Веб-расширения предоставляют дополнительные функциональные возможности клиентам Office для улучшения взаимодействия с пользователями.

Aspose.Words предоставляет возможность добавлять веб-расширения типа панели задач, используя классы WebExtension и TaskPane, а также позволяет настраивать свойства панели и расширения.

В следующем примере кода показано, как создавать панели задач и добавлять в веб-расширение панели задач с базовыми свойствами:

# 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}\"")