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

Article
08/10/2011

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

range
Type : Microsoft.Office.Interop.Word.Range
Range qui fournit les limites du contrôle.

name
Type : System.String
Nom qui peut être utilisé pour indexer le contrôle dans l'instance ControlCollection.

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

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.