Método ControlCollection.AddBookmark (Range, String)

Artigo
05/21/2013

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

range
Tipo: Microsoft.Office.Interop.Word.Range
Range que fornece os limites do controle.

name
Tipo: System.String
O nome que pode ser usado para indexar o controle na instância de ControlCollection .

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

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.