ControlCollection.AddBookmark – metoda (Range, String)

Článek
01/03/2014

Přidá nový Bookmark ovládacího prvku do dokumentu v určené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ý lze použít k řízení v rejstříku 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ž ControlCollection instance.
InvalidRangeException	Zadaný rozsah je neplatný.

Poznámky

Tato metoda umožňuje přidat Bookmark ovládacích prvků na konec ControlCollection.

Chcete-li odebrat Bookmark ovládací prvek, který byl přidán programově, použijte Remove metody.

Příklady

Následující příklad kódu přidá Bookmark ovládací prvek do dokumentu a pak přidá text na záložku.

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.