Share via


ControlCollection.AddBookmark, méthode (Range, String)

Ajoute un nouveau contrôle Bookmark au document à la plage spécifiée.

Espace de noms :  Microsoft.Office.Tools.Word
Assembly :  Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)

Syntaxe

'Déclaration
Function AddBookmark ( _
    range As Range, _
    name As String _
) As Bookmark
Bookmark AddBookmark(
    Range range,
    string name
)

Paramètres

Valeur de retour

Type : Microsoft.Office.Tools.Word.Bookmark
Contrôle Bookmark qui a été ajouté à l'instance de ControlCollection.

Exceptions

Exception Condition
ArgumentNullException

L'argument name ou range est nullune référence null (Nothing en Visual Basic) ou l'argument name a une longueur nulle.

ControlNameAlreadyExistsException

Un contrôle portant le même nom se trouve déjà dans l'instance de ControlCollection.

InvalidRangeException

La plage spécifiée n'est pas valide.

Notes

Cette méthode permet d'ajouter des contrôles Bookmark à la fin de ControlCollection.

Pour supprimer un contrôle Bookmark ajouté par programme, utilisez la méthode Remove.

Exemples

L'exemple de code suivant ajoute un contrôle Bookmark au document, puis ajoute du texte au signet.

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

Sécurité .NET Framework

Voir aussi

Référence

ControlCollection Interface

AddBookmark, surcharge

Microsoft.Office.Tools.Word, espace de noms