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

Указывает строку, используемую в качестве разделителя, если SeparateNumbers параметр имеет значение true.

Примеры

В следующем примере кода добавляется заголовок и текст в документ с помощью 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

Комментарии

Если указать wdPageNumber для значения ReferenceKind, может потребоваться повторная запись документа, чтобы просмотреть правильные сведения о перекрестных ссылках.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.