مشاركة عبر


ControlExtensions.AddRichTextBox أسلوب (ControlCollection, Range, Single, Single, String)

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

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

بناء الجملة

'إقرار
<ExtensionAttribute> _
Public Shared Function AddRichTextBox ( _
    controls As ControlCollection, _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As RichTextBox
public static RichTextBox AddRichTextBox(
    this ControlCollection controls,
    Range range,
    float width,
    float height,
    string name
)

المعلمات

  • controls
    النوع: Microsoft.Office.Tools.Word.ControlCollection
    مجموعة لإضافة عنصر تحكم إلى.لا تقم بإدخال هذه معلمة نفسك.عندما تقوم باستدعاء th هو الأسلوب في المجموعة التي تم إرجاعها بواسطة Document.Controlsخاصية (في مشروع المستوى تطبيق) أو DocumentBase.Controlsخاصية (في مشروع المستوى المستندات)، رقم هو معلمة هو الذي تم توفيره بشكل تلقائي.
  • width
    النوع: System.Single
    العرض عنصر تحكم بالنقاط.
  • height
    النوع: System.Single
    الارتفاع عنصر تحكم بالنقاط.
  • name
    النوع: System.String
    الاسم الذي يمكن أن يستخدم إلى الفهرس إلى عنصر تحكم في ControlCollectionالمثيل.

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

النوع: Microsoft.Office.Tools.Word.Controls.RichTextBox
عنصر تحكم التي تمت إضافتها إلى مستند.

ملاحظة على الاستخدام

في Visual Basic و#C، يمكنك استدعاء هذا الأسلوب كأسلوب مثيل على أي كائن من النوع ControlCollection. عند استخدام بناء جملة أسلوب مثيل لاستدعاء مثل هذا الأسلوب، احذف المعلمة الأولى. لمزيد من المعلومات، راجع أساليب ملحق (Visual Basic) أو أساليب ملحق (C# البرمجة الدليل).

استثناءات

استثناء: شرط
ArgumentNullException

nameأو rangeهو وسيطة nullمرجع خالٍ (لا شيء في Visual Basic)، أو nameعلى وسيطة صفر الطول.

ControlNameAlreadyExistsException

عنصر تحكم بنفس الاسم هو موجود بالفعل في ControlCollectionالمثيل.

InvalidRangeException

النطاق الذي تم تحديده هو غير صالح.

ملاحظات

يمكنك هذا الأسلوب من إضافة RichTextBoxالكائنات إلى النهاية ControlCollection.

إلى إزالة RichTextBoxالذي تمت إضافته برمجياً، استخدم Removeالأسلوب.

أمثلة

يلي تعليمات برمجية في المثال إضافة RichTextBoxالفقرة عنصر التحكم أول في مستند، قم بتعيين نص لعنصر التحكم، وثم تنسيقات نص. إلى لاستخدام هذا المثال، قم بتشغيلها من ThisDocumentالفئة في مشروع المستوى مستند.

Private Sub WordRangeAddRichTextBox()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim RichTextBox1 As Microsoft.Office.Tools.Word.Controls. _
        RichTextBox = Me.Controls.AddRichTextBox( _
        Me.Paragraphs(1).Range, 75, 15, "RichTextBox1")
    RichTextBox1.Text = "Sample text"
    RichTextBox1.Select(0, 6)
    RichTextBox1.SelectionFont = New Font("Times New Roman", _
        10, FontStyle.Bold)
End Sub 
private void WordRangeAddRichTextBox()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.RichTextBox
         richTextBox1 = this.Controls.AddRichTextBox(
         this.Paragraphs[1].Range, 75, 15, "richTextBox1");
    richTextBox1.Text = "Sample text";
    richTextBox1.Select(0, 6);
    richTextBox1.SelectionFont = new Font("Times New Roman",
        10, FontStyle.Bold);
}

أمن NET Framework.

راجع أيضًَا

المرجع

ControlExtensions الفئة

ControlExtensions الأعضاء

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

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