Робота з надбудовами 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";
}