Bookmark.InsertCrossReference 方法

  • 參考

定義

命名空間:
Microsoft.Office.Tools.Word
組件:
Microsoft.Office.Tools.Word.dll

將交互參照插入至標題、書籤、註腳，或附註，或插入至標題標籤所定義在 Bookmark 控制項之中的項目 (例如：方程式、圖形，或表格)。

public void InsertCrossReference (ref object ReferenceType, Microsoft.Office.Interop.Word.WdReferenceKind ReferenceKind, ref object ReferenceItem, ref object InsertAsHyperlink, ref object IncludePosition, ref object SeparateNumbers, ref object SeparatorString);
abstract member InsertCrossReference : obj * Microsoft.Office.Interop.Word.WdReferenceKind * obj * obj * obj * obj * obj -> unit
Public Sub InsertCrossReference (ByRef ReferenceType As Object, ReferenceKind As WdReferenceKind, ByRef ReferenceItem As Object, Optional ByRef InsertAsHyperlink As Object, Optional ByRef IncludePosition As Object, Optional ByRef SeparateNumbers As Object, Optional ByRef SeparatorString As Object)

參數

ReferenceType
Object

插入交互參照的項目類型。 可以是任何 WdReferenceType 或 WdCaptionLabelID 常數，或使用者定義的標題標籤。

ReferenceKind
WdReferenceKind

要包含在交互參照中的資訊。

ReferenceItem
Object

如果 為 ReferenceTypewdRefTypeBookmark，這個自變數會指定書簽名稱。 對於所有其他 ReferenceType 值，這個自變數會在 [交叉參考] 對話方塊的 [參考類型] 方塊中指定專案編號或名稱。 使用 GetCrossReferenceItems(Object) 方法傳回可以和這個引數撘配使用的項目名稱清單。

InsertAsHyperlink
Object

若要將交互參照當做超連結插入所參考的項目，則為 true，否則為 false。

IncludePosition
Object

若要根據參考項目的位置與交互參照的關係而定，在上方或下方插入，則為 true。

SeparateNumbers
Object

若要使用分隔符號分隔相關文字的數字，則為 true (只有當 ReferenceType 參數設定為 wdRefTypeNumberedItem 且 ReferenceKind 參數設定為 wdNumberFullContext.)

SeparatorString
Object

指定當參數設定true為時SeparateNumbers要當做分隔符使用的字串。

範例

下列程式代碼範例會使用 Bookmark 控件將標題和文字新增至檔，然後插入標題文字的交叉參考。

此範例適用於檔層級自定義。

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);
}

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

備註

如果您為 的值ReferenceKind指定 wdPageNumber ，您可能需要重新編頁檔，才能查看正確的交叉參考資訊。

選擇性參數

如需選擇性參數的資訊，請參閱 Office 方案中的選擇性參數。

適用於