Metoda ControlCollection.AddBookmark — (Range, String)

Artykuł
05/08/2013

Dodano 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 , który pozwala granice formantu.

name
Typ: System.String
Nazwę, która może być używane do indeksowania formantu znajdującego się w ControlCollection wystąpienie.

Wartość zwracana

Typ: Microsoft.Office.Tools.Word.Bookmark
Bookmark Formantu, 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ż pod ControlCollection wystąpienie.
InvalidRangeException	Zakres, który został określony jest nieprawidłowy.

Uwagi

Ta metoda umożliwia dodanie Bookmark formanty na koniec ControlCollection.

Aby usunąć Bookmark formantu, który został dodany programowo, w użyciu Remove metoda.

Przykłady

Poniższy przykład kodu 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 Przy użyciu bibliotek z częściowo zaufanego kodu..