Metoda ControlCollection.AddBookmark — (Range, String)
Dodaje nowy Bookmark formantu do dokumentu w określonym zakresie.
Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestaw: Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)
Składnia
'Deklaracja
Function AddBookmark ( _
range As Range, _
name As String _
) As Bookmark
Bookmark AddBookmark(
Range range,
string name
)
Parametry
- range
Typ: Microsoft.Office.Interop.Word.Range
A Range do celów kontroli i zapewniających granice.
- name
Typ: System.String
Nazwy, które mogą być używane do indeksowania formantu znajdującego się w ControlCollection wystąpienie.
Wartość zwracana
Typ: Microsoft.Office.Tools.Word.Bookmark
Bookmark Kontroli, który został dodany do ControlCollection wystąpienie.
Wyjątki
| Wyjątek | Warunek |
|---|---|
| ArgumentNullException | name Lub range argument jest nullodwołanie o wartości null (Nothing w języku Visual Basic), lub name argument ma zerową długość. |
| ControlNameAlreadyExistsException | Formant o tej samej nazwie jest już w ControlCollection wystąpienie. |
| InvalidRangeException | Określony zakres jest nieprawidłowy. |
Uwagi
Ta metoda umożliwia dodanie Bookmark formanty na koniec ControlCollection.
Aby usunąć Bookmark kontroli, który został dodany programowo, użyj Remove metody.
Przykłady
Poniższy kod dodaje Bookmark kontroli w dokumencie, a następnie dodaje tekst do zakładki.
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.";
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.