ControlCollection.AddBookmark أسلوب (Range, String)

مقالة
09/21/2010

قم بإضافة جديد Bookmarkعنصر تحكم للمستند في النطاق المحدد.

مساحة الاسم: Microsoft.Office.Tools.Word
التجميع: Microsoft.Office.Tools.Word (في Microsoft.Office.Tools.Word.dll)

بناء الجملة

'إقرار
Function AddBookmark ( _
    range As Range, _
    name As String _
) As Bookmark

Bookmark AddBookmark(
    Range range,
    string name
)

المعلمات

range
النوع: Microsoft.Office.Interop.Word.Range
Rangeوالتي توفر للحدود عنصر تحكم.

name
النوع: System.String
الاسم الذي يمكن أن يستخدم إلى الفهرس إلى عنصر تحكم في ControlCollectionالمثيل.

القيمة المُرجعة

النوع: Microsoft.Office.Tools.Word.Bookmark
Bookmarkعنصر تحكم تمت إضافته إلى ControlCollectionالمثيل.

استثناءات

استثناء:	شرط
ArgumentNullException	nameأو rangeهو وسيطة nullمرجع خالٍ (لا شيء في Visual Basic)، أو nameعلى وسيطة صفر الطول.
ControlNameAlreadyExistsException	عنصر تحكم بنفس الاسم هو موجود بالفعل في ControlCollectionالمثيل.
InvalidRangeException	النطاق الذي تم تحديده هو غير صالح.

ملاحظات

وهذا أسلوب تتيح لك إضافة Bookmarkعناصر التحكم إلى النهاية ControlCollection.

إلى إزالة Bookmarkعنصر تحكم تمت إضافته برمجياً، استخدم Removeالأسلوب.

أمثلة

يلي تعليمات برمجية المثال إضافة Bookmarkالتحكم بالمستند، ويقوم بإضافة نص إلى إشارة مرجعية.

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

أمن NET Framework.

الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.