Bookmark.InsertCrossReference Метод (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Вставляет в элемент управления Bookmark перекрестную ссылку на заголовок, закладку, сноску, концевую сноску или элемент, для которого задано название (например, в формулу, фигуру или таблицу).

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
Public 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 _
)
'Применение
Dim instance As Bookmark
Dim ReferenceType As Object
Dim ReferenceKind As WdReferenceKind
Dim ReferenceItem As Object
Dim InsertAsHyperlink As Object
Dim IncludePosition As Object
Dim SeparateNumbers As Object
Dim SeparatorString As Object

instance.InsertCrossReference(ReferenceType, _
    ReferenceKind, ReferenceItem, InsertAsHyperlink, _
    IncludePosition, SeparateNumbers, _
    SeparatorString)

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

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

Поделиться через