Officeアドインの操作

場合によっては、ドキュメントを変更するコードを実行するインターフェイスコントロールへのアクセスを許可することができます。 Aspose.WordsAPIはWebExtensions名前空間を提供し、Officeアドインを表すためのXMLボキャブラリーを拡張する要素と属性をカスタマイズするためのさまざまなクラスを付与します。

WebExtensions名前空間は条件付きで次のように分割できます:

• 作業ウィンドウを操作するためのオブジェクト
• Web拡張機能を操作するためのオブジェクト

タスクペインの使用

タスクペインは、ウィンドウの右側にMicrosoft Wordで表示されるインターフェイスサーフェスです。 作業ウィンドウでは、コードを実行してドキュメントを変更できるインターフェイスコントロールにアクセスできます。

たとえば、Aspose.WordsAPIを使用して、作業ウィンドウアドインを追加し、その外観をカスタマイズできます。

Web拡張機能の使用

Web拡張機能は、Officeアプリケーションの機能を拡張し、Officeドキュメントコンテンツと対話するツールです。 Web拡張機能は、ユーザー体験を向上させるためのOfficeクライアントに追加の機能を提供します。

Aspose.Wordsは、WebExtensionクラスとTaskPaneクラスを使用して作業ウィンドウタイプのWeb拡張機能を追加する機能を提供し、ペインと拡張機能のプロパティをカスタマイズす

次のコード例は、タスクペインを作成し、基本的なプロパティを使用してweb extensionタスクペインに追加する方法を示しています:

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";
}