مشاركة عبر


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

قم بإضافة جديد 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
)

المعلمات

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

راجع أيضًَا

المرجع

ControlCollection واجهة

ControlCollection الأعضاء

AddBookmark التحميل الزائد

Microsoft.Office.Tools.Word مساحة الاسم