ControlCollection.AddBookmark – metoda (Range, String)

Článek
05/14/2013

Přidá novou 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 indexování ovládacího prvku 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ž ControlCollection instance.
InvalidRangeException	Rozsah, který byl určen není platný.

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 metoda.

Příklady

Následující příklad kódu přidává Bookmark ovládacího prvku v dokumentu a potom 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.