Bookmark.InsertCrossReference - метод

Статья
08/11/2011

Вставляет в элемент управления 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

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

См. также

Ссылки

Bookmark Интерфейс

Microsoft.Office.Tools.Word - пространство имен

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