使用 Web 擴充任務窗格

介紹

歡迎來到這個關於使用 Aspose.Words for .NET 在 Word 文件中使用 Web 擴充任務窗格的深入教學。如果您曾經想透過互動式任務窗格增強您的 Word 文檔，那麼您來對地方了。本指南將引導您完成每一步以無縫實現這一目標。

先決條件

在我們深入之前，讓我們確保您擁有所需的一切：

Aspose.Words for .NET：您可以下載它這裡.
.NET 開發環境：Visual Studio 或您喜歡的任何其他 IDE。
C# 基礎知識：這將幫助您理解程式碼範例。
Aspose.Words 授權：您可以購買一個這裡或獲得臨時許可證這裡.

導入命名空間

在我們開始編碼之前，請確保您的專案中匯入了以下命名空間：

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 擴充參考

接下來，我們設定 Web 擴充功能參考，其中包括 ID、版本、商店類型和商店。

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

Id是網路擴充的唯一識別碼。
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 擴充功能綁定到文件的一部分？

您可以使用以下方法將 Web 擴充功能綁定到文件的一部分WebExtensionBinding類，指定綁定類型和目標 ID。

在哪裡可以找到有關 Aspose.Words for .NET 的更多資訊？

你可以找到詳細的文檔這裡.