Método ControlCollection.AddBookmark (Range, String)

Adiciona um novo controle de Bookmark ao documento no intervalo especificado.

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
Function AddBookmark ( _
    range As Range, _
    name As String _
) As Bookmark
Bookmark AddBookmark(
    Range range,
    string name
)

Parâmetros

Valor de retorno

Tipo: Microsoft.Office.Tools.Word.Bookmark
O controle de Bookmark que foi adicionado à instância de ControlCollection .

Exceções

Exceção Condição
ArgumentNullException

O argumento de name ou de range é nulluma referência nula (Nothing no Visual Basic), ou o argumento de name tem comprimento zero.

ControlNameAlreadyExistsException

Um controle com o mesmo nome já está na instância de ControlCollection .

InvalidRangeException

O intervalo que foi especificado não é válido.

Comentários

Esse método permite que você adicione controles de Bookmark ao final de ControlCollection.

Para remover Bookmark controle que foi adicionado por meio de programação, use o método de Remove .

Exemplos

O exemplo de código a seguir adiciona um controle de Bookmark ao documento, e então adiciona texto ao indexador.

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.";
}

Segurança do .NET Framework

Consulte também

Referência

ControlCollection Interface

Sobrecargas AddBookmark

Namespace Microsoft.Office.Tools.Word