將書籤控制項新增至 Word 文件

  • 發行項

在文件層級的專案中，您可以於設計階段或執行階段，將 Bookmark 控制項加入專案中的文件。 在 VSTO 增益集專案中，您可以於執行階段將 Bookmark 控制項加入任何開啟的文件。

適用對象：本主題資訊適用於文件層級的專案和 Word 的 VSTO 增益集專案。 如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

本主題說明下列工作：

在設計階段加入書籤控制項

在文件層級專案的設計階段，有數種方式可將 Bookmark 控制項加入文件：

  • 從 Visual Studio [工具箱] 。

    您可以從 [工具箱] Bookmark將 控制項拖曳至文件。 如果您已經使用 [工具箱] 將 Windows Form 控制項加入文件，您可能會想要選擇這種方式。

  • 從 Word 內部。

    您可以用加入原生書籤的方式，將 Bookmark 控制項加入文件。 用這種方式加入控制項的優點，是您可以在建立控制項時為其命名。

  • 從 [資料來源] 視窗。

    您可以從 [資料來源] Bookmark視窗將 控制項拖曳至文件。 當您想要在同一時間將控制項繫結至資料時，這會很有用。 您可以用加入 Windows Form 控制項的方式，從 [資料來源] 視窗加入主控制項。 如需詳細資訊，請參閱資料繫結和 Windows Forms。

    注意

    在下列指示的某些 Visual Studio 使用者介面項目中，您的電腦可能會顯示不同的名稱或位置： 您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。 如需詳細資訊，請參閱將 IDE 個人化。

從 [工具箱] 將書籤控制項加入文件

  1. 開啟 [工具箱] ，然後按一下 [Word 控制項] 索引標籤。

  2. 將 Bookmark 控制項拖曳至文件。

    [加入書籤] 對話方塊隨即出現。

  3. 選取您想要包含在書籤內的文字或其他項目。

  4. 按一下 [確定]。

    如果您不想保留預設的書籤名稱，您可以在 [屬性] 視窗中變更名稱。

在 Word 文件中加入書籤控制項

  1. 在裝載於 Visual Studio 設計工具的文件中，將游標放在您要加入書籤的位置，或選取您希望放在書籤中的文字。

  2. 在功能區的 [插入] 索引標籤中，按一下 [連結] 群組中的 [書籤] 按鈕。

  3. 在 [書籤] 對話方塊中，輸入新書籤的名稱，然後按一下 [加入] 。

在文件層級專案的執行階段加入書籤控制項

您可以在專案中使用 Bookmark 類別之 Controls 屬性的方法，藉此在執行階段以程式設計的方式將 ThisDocument 控制項加入文件。 有兩種方法多載可用來以下列方法加入 Bookmark 控制項：

以程式設計的方式在文件中加入書籤控制項

  1. 在專案的 ThisDocument_Startup 事件處理常式中，插入下列程式碼，在文件的第一個段落加入 Bookmark 控制項。

    Microsoft.Office.Tools.Word.Bookmark firstParagraph;
firstParagraph = this.Controls.AddBookmark(this.Paragraphs[1].Range,
    "FirstParagraph");

    注意

    如果您想要從現有的 Bookmark 建立 Bookmark控制項，請使用 AddBookmark 方法並傳入現有的 Bookmark。

在 VSTO 增益集專案中的執行階段加入書籤控制項

您可以使用 VSTO 增益集，透過程式設計的方式，在執行階段將 Bookmark 控制項加入任何開啟的文件。 若要這麼做，請產生以開啟文件為基礎的 Document 主項目，然後使用這個主項目之 Controls 屬性的方法。 有兩種方法多載可用來以下列方法加入 Bookmark 控制項：

在指定的範圍加入書籤控制項

  1. 使用 AddBookmark 方法，並傳入想要加入 Range 所在的 Bookmark。

    下列程式碼範例會在使用中文件的開頭加入新的 Bookmark 。 若要使用這個範例，請從 Word VSTO 增益集專案的 ThisAddIn_Startup 事件處理常式執行程式碼。

    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);


Bookmark firstParagraph = extendedDocument.Controls.AddBookmark(
    extendedDocument.Paragraphs[1].Range, "FirstParagraph");

加入以原生書籤控制項為基礎的書籤控制項

  1. 使用 AddBookmark 方法，並傳入您想要用做新 Bookmark 之基礎的現有 Bookmark。

    下列程式碼範例會根據使用中文件的第一個 Bookmark 建立新的 Bookmark 若要使用這個範例，請從 Word VSTO 增益集專案的 ThisAddIn_Startup 事件處理常式執行程式碼。

    if (this.Application.ActiveDocument.Bookmarks.Count > 0)
{
    object index = 1;
    Word.Bookmark firstBookmark = this.Application.ActiveDocument.Bookmarks.get_Item(ref index);


     Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);

    Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
            firstBookmark, "VSTOBookmark");
}

相關內容