ControlCollection.AddBookmark – metoda (Range, String)

Článek
08/11/2011

Přidá nový Bookmark Řízení dokumentu v zadaném rozsahu.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
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 , který poskytuje hranice ovládacího prvku.

name
Typ: System.String
Název, který může být použit index řízení v ControlCollection instance.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Word.Bookmark
Bookmark Ovládací prvek, který byl přidán ControlCollection instance.

Výjimky

Výjimka	Podmínka
ArgumentNullException	name Nebo range argument je nullodkaz Null (Nothing v jazyce Visual Basic), nebo name argument má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již v ControlCollection instance.
InvalidRangeException	Určený rozsah je platný.

Poznámky

Tato metoda umožňuje přidat Bookmark ovládací prvky na konci ControlCollection.

Odebrání Bookmark programově přidat ovládací prvek, použijte Remove metody.

Příklady

Následující příklad kódu přidá Bookmark řízení do dokumentu a pak přidá text záložka.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.