ControlCollection.AddBookmark Метод (Range, String) (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 Function AddBookmark ( _
    range As Range, _
    name As String _
) As Bookmark
'Применение
Dim instance As ControlCollection
Dim range As Range
Dim name As String
Dim returnValue As Bookmark

returnValue = instance.AddBookmark(range, _
    name)

public Bookmark AddBookmark(
    Range range,
    string name
)

Параметры

range
Тип: Microsoft.Office.Interop.Word.Range
Объект Range, предоставляющий границы элемента управления.

name
Тип: System.String
Имя, которое можно использовать для индексации элемента управления в экземпляре класса ControlCollection.

Возвращаемое значение

Тип: Microsoft.Office.Tools.Word.Bookmark
Элемент управления Bookmark, добавленный в экземпляр коллекции ControlCollection.

Исключения

Исключение	Условие
ArgumentNullException	Аргумент name или range равен nullссылка null (Nothing в Visual Basic), или аргумент name имеет нулевую длину.
ControlNameAlreadyExistsException	Элемент управления с таким именем уже имеется в данном экземпляре класса ControlCollection.
InvalidRangeException	Указанный диапазон не существует.

Заметки

Этот метод используется для добавления элементов управления Bookmark в конец коллекции ControlCollection.

Чтобы удалить добавленный программно элемент управления Bookmark, воспользуйтесь методом Remove.

Примеры

В приведенном ниже примере кода в документ добавляется элемент управления Bookmark, после чего в закладку добавляется текст.

Private Sub WordAddBookmark()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark _
        = Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    Bookmark1.Text = "This is sample bookmark text."

End Sub

private void WordAddBookmark()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    bookmark1.Text = "This is sample bookmark text.";
}

Разрешения

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