Método ControlCollection.AddBookmark (Range, String)
Adiciona um novo Bookmark o controle para o 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
A Range que fornece os limites para o controle.
- name
Tipo: System.String
O nome que pode ser usado para indexar o controle de ControlCollection instância.
Valor de retorno
Tipo: Microsoft.Office.Tools.Word.Bookmark
O Bookmark controle foi adicionado para o ControlCollection instância.
Exceções
Exceção | Condição |
---|---|
ArgumentNullException | O name ou range argumento é nulluma referência nula (Nothing no Visual Basic), ou o name argumento tem comprimento zero. |
ControlNameAlreadyExistsException | Um controle com o mesmo nome já está na ControlCollection instância. |
InvalidRangeException | O intervalo especificado não é válido. |
Comentários
Esse método permite que você adicione Bookmark controles para o fim da ControlCollection.
Para remover um Bookmark o controle que tenha sido adicionado programaticamente, use o Remove método.
Exemplos
O exemplo de código a seguir adiciona um Bookmark o controle para o documento e, em seguida, adiciona o texto do indicador.
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.