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
- 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 nullNULL-Verweis (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.