書籤控制項

Microsoft.Office.Tools.Word.Bookmark 控制項是具有唯一名稱、能公開事件且繫結至資料的書籤。書籤可以做為預留位置，以標記 Microsoft Office Word 文件中的項目或位置。 Microsoft.Office.Tools.Word.Bookmark 控制項是 Microsoft.Office.Interop.Word.Bookmark 物件和 Microsoft.Office.Interop.Word.Range 物件的結合。

**適用於：**本主題中的資訊適用於 Word 2007 和 Word 2010 的文件層級專案和應用程式層級專案。如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

在文件層級專案中，您可以在設計階段或執行階段將 Microsoft.Office.Tools.Word.Bookmark 控制項加入至文件。在應用程式層級專案中，您可以在執行階段將 Microsoft.Office.Tools.Word.Bookmark 控制項加入至任何開啟的文件。如需詳細資訊，請參閱 HOW TO：將書籤控制項加入至 Word 文件。

將資料繫結至控制項

Microsoft.Office.Tools.Word.Bookmark 控制項支援簡單的資料繫結。應該將書籤繫結至使用 DataBindings 屬性的資料來源。書籤的預設資料繫結屬性是 Text 屬性。

如果更新繫結資料集中的資料，則 Microsoft.Office.Tools.Word.Bookmark 控制項會反映這些變更。

在文件層級專案中，您可以使用 [資料來源] 視窗將資料繫結至書籤。如需詳細資訊，請參閱 HOW TO：將物件的資料填入文件。

可套用至 Microsoft.Office.Interop.Word.Bookmark 的格式，也可以套用至 Microsoft.Office.Tools.Word.Bookmark 控制項。這包括字型、縮排、間距、編號方式和樣式。

Microsoft.Office.Interop.Word.Bookmark 物件和 Microsoft.Office.Tools.Word.Bookmark 控制項之間的另一個差異是，將文字指派給書籤時其不同的運作方式。如果您將文字指派給長度為零的 Microsoft.Office.Interop.Word.Bookmark，則文字會附加至書籤的右端，且書籤仍保持長度為零。不過，如果您將文字指派給長度為零的 Microsoft.Office.Tools.Word.Bookmark，則文字會插入書籤中，且書籤的長度會延長為插入的字元總數。

Text 屬性	說明
Bookmark.Text	使用這個屬性可以在書籤內顯示文字，並將書籤留在文件上。指派文字給書籤會擴展書籤範圍，但不會刪除該書籤。例如，Bookmark1.Text = "Hello world" 會將文字插入書籤，並使書籤保留不變。
Range.Text	使用這個屬性可以在書籤位置顯示文字，並自動刪除書籤。例如，Bookmark1.Range.Text = "Hello world" 會將文字插入書籤，並刪除該書籤。

使用這個屬性可以在書籤內顯示文字，並將書籤留在文件上。指派文字給書籤會擴展書籤範圍，但不會刪除該書籤。

例如，Bookmark1.Text = "Hello world" 會將文字插入書籤，並使書籤保留不變。

使用這個屬性可以在書籤位置顯示文字，並自動刪除書籤。例如，Bookmark1.Range.Text = "Hello world" 會將文字插入書籤，並刪除該書籤。

在文件層級專案中，當您將 Microsoft.Office.Tools.Word.Bookmark 控制項從 [工具箱] 拖曳至文件時，Visual Studio 會自動產生該控制項的名稱。您可以在 [屬性] 視窗中變更控制項的名稱。

書籤控制項可以互相重疊，也就是說，多個書籤可以共用相同的文字。當您將新文字指派給其中一個重疊書籤時，它只會包含新文字，且書籤將不再互相重疊。其他書籤現在將只包含原始重疊書籤之間沒有共用的文字。

下表顯示兩個重疊書籤如何共用「這是範例文字。」句子。

如果您指派新文字「這是取代文字。」給書籤 1，則書籤將不再重疊，且書籤 2 只會保留原本不屬於書籤 1 的文字。

如果某個書籤完全包含在另一個書籤內，而且您變更了外部書籤的文字，則內部書籤不會被刪除。不過，內部書籤會成為移至外部書籤尾端的空白書籤。下表顯示包含在另一個書籤內的書籤如何共用「這是範例文字。」句子。

如果您指派新文字「這是取代文字。」給書籤 1，則書籤將不再重疊，且書籤 2 會成為位於書籤 1 尾端的空白書籤。