Bookmark.InsertCrossReference 方法
將交互參照插入至標題、書籤、註腳，或附註，或插入至標題標籤所定義在 Bookmark 控制項之中的項目 (例如：方程式、圖形，或表格)。
命名空間： Microsoft.Office.Tools.Word
組件： Microsoft.Office.Tools.Word (在 Microsoft.Office.Tools.Word.dll 中)
語法
'宣告
Sub InsertCrossReference ( _
ByRef ReferenceType As Object, _
ReferenceKind As WdReferenceKind, _
ByRef ReferenceItem As Object, _
ByRef InsertAsHyperlink As Object, _
ByRef IncludePosition As Object, _
ByRef SeparateNumbers As Object, _
ByRef SeparatorString As Object _
)
void InsertCrossReference(
ref Object ReferenceType,
WdReferenceKind ReferenceKind,
ref Object ReferenceItem,
ref Object InsertAsHyperlink,
ref Object IncludePosition,
ref Object SeparateNumbers,
ref Object SeparatorString
)
參數
- ReferenceType
型別：System.Object%
插入交互參照的項目類型。可以是任何 WdReferenceType 或 WdCaptionLabelID 常數，或使用者定義的標題標籤。
- ReferenceKind
型別：Microsoft.Office.Interop.Word.WdReferenceKind
要包含在交互參照中的資訊。
- ReferenceItem
型別：System.Object%
如果 ReferenceType 是 wdRefTypeBookmark，這個引數就會指定書籤名稱。針對所有其他的 ReferenceType 值，這個引數會在 [交互參照] 對話方塊的 [參考型別] 方塊中指定項目數目或名稱。使用 GetCrossReferenceItems 方法傳回可以和這個引數撘配使用的項目名稱清單。
- InsertAsHyperlink
型別：System.Object%
若要將交互參照當做超連結插入所參考的項目，則為 true，否則為 false。
- IncludePosition
型別：System.Object%
若要根據參考項目的位置與交互參照的關係而定，在上方或下方插入，則為 true。
- SeparateNumbers
型別：System.Object%
若要使用分隔符號分隔相關文字的數字，則為 true (只有在 ReferenceType 參數設定為 wdRefTypeNumberedItem 且 ReferenceKind 參數設定為 wdNumberFullContext 時才使用)。
- SeparatorString
型別：System.Object%
如果 SeparateNumbers 參數設定為 true，便指定用以做為分隔符號的字串。
備註
如果您為 ReferenceKind 的值指定 wdPageNumber，就可能需要為文件重新編頁，才能參閱到正確的交互參照資訊。
選擇性參數
如需選擇性參數的詳細資訊，請參閱Office 方案中的選擇性參數。
範例
下列程式碼會使用 Bookmark 控制項將標題和文字加入至這份文件，然後在標題文字中插入交互參照。
這是示範文件層級自訂的範例。
Private Sub BookmarkInsertCrossReference()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
Bookmark1.Text = "Heading of Document"
Bookmark1.Style = "Heading 1"
Bookmark1.Delete()
Dim Bookmark2 As Microsoft.Office.Tools.Word.Bookmark = _
Me.Controls.AddBookmark(Me.Paragraphs(2).Range, "Bookmark2")
Bookmark2.Text = "This is sample bookmark text: "
Bookmark2.Words.Last.InsertCrossReference("Heading", _
Word.WdReferenceKind.wdContentText, "1", True, _
False, False, " ")
End Sub
private void BookmarkInsertCrossReference()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Bookmark bookmark1 =
this.Controls.AddBookmark(this.Paragraphs[1].Range,
"bookmark1");
bookmark1.Text = "Heading of Document";
bookmark1.Style = "Heading 1";
bookmark1.Delete();
Microsoft.Office.Tools.Word.Bookmark bookmark2 =
this.Controls.AddBookmark(this.Paragraphs[2].Range,
"bookmark2");
bookmark2.Text = "This is sample bookmark text: ";
object ReferenceType = "Heading";
object ReferenceItem = "1";
object InsertAsHyperlink = true;
object IncludePosition = false;
object SeparateNumbers = false;
object SeparatorString = " ";
bookmark2.Words.Last.InsertCrossReference(ref ReferenceType,
Word.WdReferenceKind.wdContentText, ref ReferenceItem,
ref InsertAsHyperlink, ref IncludePosition,
ref SeparateNumbers, ref SeparatorString);
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。