Работа с надстройками 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-C | |
System::SharedPtr<Document> doc = System::MakeObject<Document>(); | |
System::SharedPtr<TaskPane> taskPane = System::MakeObject<TaskPane>(); | |
doc->get_WebExtensionTaskPanes()->Add(taskPane); | |
taskPane->set_DockState(TaskPaneDockState::Right); | |
taskPane->set_IsVisible(true); | |
taskPane->set_Width(300); | |
taskPane->get_WebExtension()->get_Reference()->set_Id(u"wa102923726"); | |
taskPane->get_WebExtension()->get_Reference()->set_Version(u"1.0.0.0"); | |
taskPane->get_WebExtension()->get_Reference()->set_StoreType(WebExtensionStoreType::OMEX); | |
taskPane->get_WebExtension()->get_Reference()->set_Store(u"th-TH"); | |
doc->Save(outputDataDir + u"WorkingWithWebExtension.UsingWebExtensionTaskPanes.docx", SaveFormat::Docx); |
Чтобы просмотреть список надстроек панели задач, используйте свойство WebExtensionTaskPanes.
В следующем примере кода показано, как получить такой список надстроек:
For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C | |
doc = System::MakeObject<Document>(outputDataDir + u"WorkingWithWebExtension.UsingWebExtensionTaskPanes.docx"); | |
std::cout << "Task panes sources:\n"; | |
for (auto taskPane : IterateOver(doc->get_WebExtensionTaskPanes())) | |
{ | |
auto reference = taskPane->get_WebExtension()->get_Reference(); | |
std::cout << "Provider: \"" << reference->get_Store().ToUtf8String() | |
<< "\", version: \"" << reference->get_Version().ToUtf8String() | |
<< "\", catalog identifier: \"" << reference->get_Id().ToUtf8String() << "\"\n"; | |
} |