Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
- range
Typ: Microsoft.Office.Interop.Word.Range
Ein Range, der die Begrenzungen des Steuerelements angibt.
- name
Typ: System.String
Der Name, der zum Indizieren des Steuerelements in der ControlCollection-Instanz verwendet werden kann.
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
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.