Web拡張機能タスクパネルの使用

導入

Aspose.Words for .NET を使用して Word 文書で Web 拡張機能タスク ペインを使用する方法について詳しく説明したチュートリアルへようこそ。対話型タスク ペインを使用して Word 文書を強化したいとお考えの場合は、このガイドが役に立ちます。このガイドでは、これをシームレスに実現するためのすべての手順を説明します。

前提条件

始める前に、必要なものがすべて揃っていることを確認しましょう。

  • Aspose.Words for .NET: ダウンロードできますここ.
  • .NET 開発環境: Visual Studio または任意の他の IDE。
  • C# の基礎知識: コード例を理解するのに役立ちます。
  • Aspose.Wordsのライセンス: 1つ購入できますここまたは一時免許を取得するここ.

名前空間のインポート

コーディングを開始する前に、プロジェクトに次の名前空間がインポートされていることを確認してください。

using Aspose.Words;
using Aspose.Words.WebExtensions;

ステップバイステップガイド

それでは、プロセスをわかりやすいステップに分解してみましょう。

ステップ1: ドキュメントディレクトリの設定

まず最初に、ドキュメント ディレクトリへのパスを設定する必要があります。ここに Word 文書が保存されます。

//ドキュメント ディレクトリへのパス。
string dataDir = "YOUR DOCUMENT DIRECTORY";

交換する"YOUR DOCUMENT DIRECTORY"ドキュメント フォルダーへの実際のパスを入力します。

ステップ2: 新しいドキュメントを作成する

次に、Aspose.Words を使用して新しい Word 文書を作成します。

Document doc = new Document();

この行は、Document Word 文書を表すクラス。

ステップ3: タスクペインの追加

ここで、ドキュメントにタスク ウィンドウを追加します。タスク ウィンドウは、Word ドキュメント内で追加の機能やツールを提供するのに役立ちます。

TaskPane taskPane = new TaskPane();
doc.WebExtensionTaskPanes.Add(taskPane);

ここで、新しいTaskPaneオブジェクトを作成し、それをドキュメントに追加しますWebExtensionTaskPanesコレクション。

ステップ4: タスクペインの構成

タスク ペインを表示し、そのプロパティを設定するには、次のコードを使用します。

taskPane.DockState = TaskPaneDockState.Right;
taskPane.IsVisible = true;
taskPane.Width = 300;
  • DockStateタスク ペインが表示される場所を設定します。この場合は右側です。
  • IsVisibleタスク ペインが表示されるようにします。
  • Widthタスク ペインの幅を設定します。

ステップ5: Web拡張機能リファレンスの設定

次に、ID、バージョン、ストア タイプ、ストアを含む Web 拡張機能リファレンスを設定します。

taskPane.WebExtension.Reference.Id = "wa102923726";
taskPane.WebExtension.Reference.Version = "1.0.0.0";
taskPane.WebExtension.Reference.StoreType = WebExtensionStoreType.OMEX;
taskPane.WebExtension.Reference.Store = "th-TH";
  • IdWeb 拡張機能の一意の識別子です。
  • Version拡張機能のバージョンを指定します。
  • StoreType店舗の種類を示します (この場合は OMEX)。
  • Storeストアの言語/文化コードを指定します。

ステップ6: Web拡張機能にプロパティを追加する

Web 拡張機能にプロパティを追加して、その動作やコンテンツを定義できます。

taskPane.WebExtension.Properties.Add(new WebExtensionProperty("mailchimpCampaign", "mailchimpCampaign"));

ここで、mailchimpCampaign.

ステップ7: Web拡張機能のバインド

最後に、Web 拡張機能にバインディングを追加します。バインディングを使用すると、拡張機能をドキュメントの特定の部分にリンクできます。

taskPane.WebExtension.Bindings.Add(new WebExtensionBinding("UnnamedBinding_0_1506535429545", WebExtensionBindingType.Text, "194740422"));
  • UnnamedBinding_0_1506535429545バインディングの名前です。
  • WebExtensionBindingType.Textバインディングがテキスト タイプであることを示します。
  • 194740422拡張機能がバインドされているドキュメントの部分の ID です。

ステップ8: ドキュメントを保存する

すべてを設定したら、ドキュメントを保存します。

doc.Save(dataDir + "WorkingWithWebExtension.UsingWebExtensionTaskPanes.docx");

この行は、指定されたファイル名で指定されたディレクトリにドキュメントを保存します。

ステップ 9: タスク ペインの情報を読み込んで表示する

タスク ウィンドウの情報を確認して表示するには、ドキュメントを読み込み、タスク ウィンドウを反復処理します。

doc = new Document(dataDir + "WorkingWithWebExtension.UsingWebExtensionTaskPanes.docx");

Console.WriteLine("Task panes sources:\n");

foreach (TaskPane taskPaneInfo in doc.WebExtensionTaskPanes)
{
    WebExtensionReference reference = taskPaneInfo.WebExtension.Reference;
    Console.WriteLine($"Provider: \"{reference.Store}\", version: \"{reference.Version}\", catalog identifier: \"{reference.Id}\";");
}

このコードはドキュメントを読み込み、各タスク ウィンドウのプロバイダー、バージョン、およびカタログ識別子をコンソールに出力します。

結論

これで完了です。Aspose.Words for .NET を使用して、Word 文書に Web 拡張タスク ペインを追加し、構成できました。この強力な機能により、文書内に直接追加機能が提供され、Word 文書が大幅に強化されます。

よくある質問

Word のタスク ウィンドウとは何ですか?

タスク ウィンドウは、Word 文書内で追加のツールと機能を提供し、ユーザーの操作性と生産性を向上させるインターフェイス要素です。

タスク ペインの外観をカスタマイズできますか?

はい、次のようなプロパティを設定することでタスクペインの外観をカスタマイズできます。DockState, IsVisible 、 そしてWidth.

Web 拡張プロパティとは何ですか?

Web 拡張機能プロパティは、Web 拡張機能に追加してその動作やコンテンツを定義することができるカスタム プロパティです。

Web 拡張機能をドキュメントの一部にバインドするにはどうすればよいですか?

ウェブ拡張機能をドキュメントの一部にバインドするには、WebExtensionBindingクラス、バインディング タイプとターゲット ID を指定します。

Aspose.Words for .NET の詳細情報はどこで入手できますか?

詳細なドキュメントは以下をご覧くださいここ.