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

如果 ReferenceType 为 wdRefTypeBookmark，则此参数指定书签名称。 对于所有其他 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 解决方案中的可选参数。