مشاركة عبر


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

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

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

بناء الجملة

'إقرار
<ExtensionAttribute> _
Public Shared Function AddRadioButton ( _
    controls As ControlCollection, _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As RadioButton
public static RadioButton AddRadioButton(
    this ControlCollection controls,
    float left,
    float top,
    float width,
    float height,
    string name
)

المعلمات

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

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

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

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

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

استثناءات

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

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

ControlNameAlreadyExistsException

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

ملاحظات

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

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

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

أمثلة

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

Private Sub WordAddRadioButton()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim RadioButton1 As Microsoft.Office.Tools.Word.Controls. _
        RadioButton = Me.Controls.AddRadioButton(0, 0, 78, 18, _
        "RadioButton1")
    Dim RadioButton2 As Microsoft.Office.Tools.Word.Controls. _
        RadioButton = Me.Controls.AddRadioButton(0, 18, 78, 18, _
        "RadioButton2")
    RadioButton1.Text = "Bold"
    RadioButton2.Text = "Italic"
End Sub 
private void WordAddRadioButton()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.RadioButton
         radioButton1 = this.Controls.AddRadioButton(
         0, 0, 78, 18, "radioButton1");
    Microsoft.Office.Tools.Word.Controls.RadioButton
         radioButton2 = this.Controls.AddRadioButton(
         0, 18, 78, 18, "radioButton2");
    radioButton1.Text = "Bold";
    radioButton2.Text = "Italic";
}

أمن NET Framework.

راجع أيضًَا

المرجع

ControlExtensions الفئة

ControlExtensions الأعضاء

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

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