Metodo ControlCollection.AddBookmark (Range, String)

Articolo
08/11/2011

Aggiunge un nuovo controllo Bookmark al documento in corrispondenza dell'intervallo specificato.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

'Dichiarazione
Function AddBookmark ( _
    range As Range, _
    name As String _
) As Bookmark

Bookmark AddBookmark(
    Range range,
    string name
)

Parametri

range
Tipo: Microsoft.Office.Interop.Word.Range
Oggetto Range che fornisce i limiti del controllo.

name
Tipo: System.String
Nome utilizzabile per l'indicizzazione del controllo nell'istanza di ControlCollection.

Valore restituito

Tipo: Microsoft.Office.Tools.Word.Bookmark
Controllo Bookmark aggiunto all'istanza di ControlCollection.

Eccezioni

Eccezione	Condizione
ArgumentNullException	L'argomento name o range è nullriferimento null (Nothing in Visual Basic) oppure l'argomento name ha lunghezza zero.
ControlNameAlreadyExistsException	Nell'istanza di ControlCollection è già presente un controllo con lo stesso nome.
InvalidRangeException	L'intervallo specificato non è valido.

Note

Questo metodo consente di aggiungere controlli Bookmark alla fine dell'insieme ControlCollection.

Per rimuovere un controllo Bookmark aggiunto a livello di codice, utilizzare il metodo Remove.

Esempi

Nell'esempio di codice seguente viene aggiunto un controllo Bookmark al documento, quindi viene aggiunto testo nel segnalibro.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.