ControlCollection.AddBookmark (Método) (Range, String)

Artículo
08/10/2011

Agrega un nuevo control Bookmark al documento en el intervalo especificado.

Espacio de nombres: Microsoft.Office.Tools.Word
Ensamblado: Microsoft.Office.Tools.Word (en Microsoft.Office.Tools.Word.dll)

Sintaxis

'Declaración
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 proporciona los límites del control.

name
Tipo: System.String
Nombre que se puede usar para indizar el control en la instancia de ControlCollection.

Valor devuelto

Tipo: Microsoft.Office.Tools.Word.Bookmark
El control Bookmark que se ha agregado a la instancia de ControlCollection.

Excepciones

Excepción	Condición
ArgumentNullException	El argumento name o range es nullreferencia null (Nothing en Visual Basic) o el argumento name tiene longitud cero.
ControlNameAlreadyExistsException	Ya existe un control con el mismo nombre en la instancia de ControlCollection.
InvalidRangeException	El intervalo especificado no es válido.

Comentarios

Este método permite agregar controles Bookmark al final de la colección ControlCollection.

Para quitar un control Bookmark agregado mediante programación, utilice el método Remove.

Ejemplos

En el ejemplo de código siguiente se agrega un control Bookmark al documento y, a continuación, se agrega texto al marcador.

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

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.