Freigeben über


ControlCollection.AddBookmark-Methode (Range, String)

Fügt dem Dokument im angegebenen Bereich ein neues Bookmark-Steuerelement hinzu.

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

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

Parameter

Rückgabewert

Typ: Microsoft.Office.Tools.Word.Bookmark
Das Bookmark-Steuerelement, das der ControlCollection-Instanz hinzugefügt wurde.

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

Das name-Argument oder das range-Argument ist nullein Nullverweis (Nothing in Visual Basic), oder das name-Argument hat die Länge 0 (null).

ControlNameAlreadyExistsException

Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection-Instanz vorhanden.

InvalidRangeException

Der angegebene Bereich ist nicht gültig.

Hinweise

Mithilfe dieser Methode können Sie Bookmark-Steuerelemente am Ende der ControlCollection hinzufügen.

Um ein Bookmark-Steuerelement zu entfernen, das programmgesteuert hinzugefügt wurde, verwenden Sie die Remove-Methode.

Beispiele

Im folgenden Codebeispiel wird dem Dokument ein Bookmark-Steuerelement hinzugefügt. Anschließend wird dem Lesezeichen Text hinzugefügt.

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

.NET Framework-Sicherheit

Siehe auch

Referenz

ControlCollection Schnittstelle

AddBookmark-Überladung

Microsoft.Office.Tools.Word-Namespace