書籤控制項
更新： 2008 年 7 月
適用於 |
|---|
本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。 文件層級專案
應用程式層級專案
如需詳細資訊，請參閱依應用程式和專案類型提供的功能。 |
Bookmark 控制項是具有唯一名稱、公開事件並可繫結至資料的書籤。書籤可以做為預留位置，以標記 Microsoft Office Word 文件中的項目或位置。
Bookmark 控制項是 Microsoft.Office.Interop.Word.Bookmark 物件和 Microsoft.Office.Interop.Word.Range 物件的結合。將書籤加入至文件時，Visual Studio Tools for Office 會建立書籤物件，您可以直接針對該書籤物件撰寫程式，而不需周遊 Word 物件模型。
在文件層級專案中，您可以在設計階段或執行階段將 Bookmark 控制項加入至文件。從 Visual Studio 2008 Service Pack 1 (SP1) 開始，您也可以使用 Word 2007 的應用程式層級增益集，在執行階段將 Bookmark 控制項加入至任何開啟的文件。如需詳細資訊，請參閱 HOW TO：將書籤控制項加入至 Word 文件。
將資料繫結至控制項
Bookmark 控制項支援簡單的資料繫結。應該將書籤繫結至使用 DataBindings 屬性的資料來源。書籤的預設資料繫結屬性是 Text 屬性。
如果更新繫結資料集中的資料，則 Bookmark 控制項會反映這些變更。
在文件層級專案中，您可以使用 [資料來源] 視窗將資料繫結至書籤。如需詳細資訊，請參閱 HOW TO：將物件的資料填入文件。
格式
可套用至 Microsoft.Office.Interop.Word.Bookmark 的格式，也可以套用至 Bookmark 控制項。這包括字型、縮排、間距、編號方式和樣式。
指派文字至書籤
Microsoft.Office.Interop.Word.Bookmark 物件和 Bookmark 控制項之間的另一個差異是，將文字指派給書籤時其不同的運作方式。如果您將文字指派給長度為零的 Microsoft.Office.Interop.Word.Bookmark，則文字會附加至書籤的右端，且書籤仍保持長度為零。不過，如果您將文字指派給長度為零的 Bookmark，則文字會插入書籤中，且書籤的長度會延長為插入的字元總數。
此外，Visual Studio Tools for Office 會將 Bookmark.Text 屬性加入至 Bookmark 控制項。這與書籤的 Range 上可以使用的 Range.Text 屬性不同。
Text 屬性 |
說明 |
|---|---|
使用這個屬性可以在書籤內顯示文字，並將書籤留在文件上。指派文字給書籤會擴展書籤範圍，但不會刪除該書籤。 例如，Bookmark1.Text = "Hello world" 會將文字插入書籤，並使書籤保留不變。 |
|
使用這個屬性可以在書籤位置顯示文字，並自動刪除書籤。例如，Bookmark1.Range.Text = "Hello world" 會將文字插入書籤，並刪除該書籤。 |
在設計階段重新命名控制項
在文件層級專案中，當您將 Bookmark 控制項從 [工具箱] 拖曳至文件時，Visual Studio Tools for Office 會自動產生該控制項的名稱。您可以在 [屬性] 視窗中變更控制項的名稱。
重疊控制項
書籤控制項可以互相重疊，也就是說，多個書籤可以共用相同的文字。當您將新文字指派給其中一個重疊書籤時，它只會包含新文字，且書籤將不再互相重疊。其他書籤現在將只包含原始重疊書籤之間沒有共用的文字。
下表顯示兩個重疊書籤如何共用「這是範例文字。」句子。
書籤 |
文字 |
|---|---|
重疊書籤 |
[這是 {範例] 文字。} |
書籤 1 |
這是範例 |
書籤 2 |
範例文字。 |
如果您指派新文字「這是取代文字。」給書籤 1，則書籤將不再重疊，且書籤 2 只會保留原本不屬於書籤 1 的文字。
書籤 |
文字 |
|---|---|
兩個單獨的書籤 |
[這是取代文字]{文字。} |
書籤 1 |
這是取代文字 |
書籤 2 |
文字。 |
如果某個書籤完全包含在另一個書籤內，而且您變更了外部書籤的文字，則內部書籤不會被刪除。不過，內部書籤會成為移至外部書籤尾端的空白書籤。下表顯示包含在另一個書籤內的書籤如何共用「這是範例文字。」句子。
書籤 |
文字 |
|---|---|
重疊書籤 |
[這是 {範例} 文字。] |
書籤 1 |
這是範例文字。 |
書籤 2 |
範例 |
如果您指派新文字「這是取代文字。」給書籤 1，則書籤將不再重疊，且書籤 2 會成為位於書籤 1 尾端的空白書籤。
書籤 |
文字 |
|---|---|
兩個單獨的書籤 |
[這是取代文字。]{} |
書籤 1 |
這是取代文字。 |
書籤 2 |
<empty> |
事件
下列事件適用於 Bookmark 控制項：
請參閱
工作
概念
其他資源
變更記錄
日期 |
記錄 |
原因 |
|---|---|---|
|
2008 年 7 月 |
加入有關透過應用程式層級專案使用書籤控制項的資訊。 |
SP1 功能變更。 |