ControlExtensions.AddRadioButton أسلوب (ControlCollection, Double, Double, Double, Double, String)
قم بإضافة جديد RadioButtonعنصر تحكم في ورقة عمل في الحجم المحدد والموقع.
مساحة الاسم: Microsoft.Office.Tools.Excel
التجميع: Microsoft.Office.Tools.Excel.v4.0.Utilities (في Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
بناء الجملة
'إقرار
<ExtensionAttribute> _
Public Shared Function AddRadioButton ( _
controls As ControlCollection, _
left As Double, _
top As Double, _
width As Double, _
height As Double, _
name As String _
) As RadioButton
public static RadioButton AddRadioButton(
this ControlCollection controls,
double left,
double top,
double width,
double height,
string name
)
المعلمات
- controls
النوع: Microsoft.Office.Tools.Excel.ControlCollection
مجموعة لإضافة عنصر تحكم إلى.لا تقم بإدخال هذه معلمة نفسك.عندما تقوم باستدعاء th هو الأسلوب في المجموعة التي تم إرجاعها بواسطة Worksheet.Controlsخاصية (في مشروع المستوى تطبيق) أو WorksheetBase.Controlsخاصية (في مشروع المستوى المستندات)، رقم هو معلمة هو الذي تم توفيره بشكل تلقائي.
- left
النوع: System.Double
المسافة بالنقاط بين الحافة اليمنى عنصر تحكم والحافة اليسرى لورقة العمل.
- top
النوع: System.Double
المسافة بالنقاط بين الحافة العلوية من عنصر تحكم والحافة العليا لورقة العمل.
- width
النوع: System.Double
العرض عنصر تحكم بالنقاط.
- height
النوع: System.Double
الارتفاع عنصر تحكم بالنقاط.
- name
النوع: System.String
الاسم عنصر تحكم.
القيمة المُرجعة
النوع: Microsoft.Office.Tools.Excel.Controls.RadioButton
RadioButtonعنصر تحكم تمت إضافته إلى ControlCollectionالمثيل.
ملاحظة على الاستخدام
في Visual Basic و#C، يمكنك استدعاء هذا الأسلوب كأسلوب مثيل على أي كائن من النوع ControlCollection. عند استخدام بناء جملة أسلوب مثيل لاستدعاء مثل هذا الأسلوب، احذف المعلمة الأولى. لمزيد من المعلومات، راجع أساليب ملحق (Visual Basic) أو أساليب ملحق (C# البرمجة الدليل).
استثناءات
استثناء: | شرط |
---|---|
ArgumentNullException | وسيطة "اسم" هو nullمرجع خالٍ (لا شيء في Visual Basic)أو صفرية الطول. |
ControlNameAlreadyExistsException | عنصر تحكم بنفس الاسم هو موجود بالفعل في ControlCollectionالمثيل. |
ملاحظات
AddRadioButtonأسلوب تمكنك من إضافة RadioButtonالكائنات إلى النهاية ControlCollection. لإزالة RadioButtonعنصر تحكم الذي تم مسبقاً إضافته برمجياً، استخدم Removeالأسلوب.
عندما تقوم بإضافة أزرار الخيارات المتعددة مباشرةً إلى المستند, لا تستبعد الأزرار التبادلية بعضها بعضاً. يمكنك كتابة تعليمات برمجية لجعل أزرار التبادلية يستبعد بعضها بعضاً; و مع ذلك، يعتبر الأسلوب المفضل هو إضافة الأزرار التبادلية إلى عنصر تحكم المستخدم و إضافة عنصر تحكم المستخدم إلى المستند.
أمثلة
يلي تعليمات برمجية المثال إضافة الثاني RadioButtonوعناصر التحكم إلى أعلى ورقة عمل، وبعد ذلك بتعيين نص لكل عنصر تحكم. إلى لاستخدام هذا المثال، قم بتشغيلها من Sheet1الفئة في مشروع المستوى مستند.
Private Sub ExcelAddRadioButton()
Dim RadioButton1 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(0, 0, 78, 18, "RadioButton1")
Dim RadioButton2 As Microsoft.Office.Tools. _
Excel.Controls.RadioButton = Me.Controls. _
AddRadioButton(0, 18, 78, 18, "RadioButton2")
RadioButton1.Text = "Bold"
RadioButton2.Text = "Italic"
RadioButton2.Checked = False
End Sub
private void ExcelAddRadioButton()
{
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton1 = this.Controls.AddRadioButton(
0, 0, 78, 18, "radioButton1");
Microsoft.Office.Tools.Excel.Controls.RadioButton
radioButton2 = this.Controls.AddRadioButton(
0, 18, 78, 18, "radioButton2");
radioButton1.Text = "Bold";
radioButton2.Text = "Italic";
radioButton2.Checked = false;
}
أمن NET Framework.
- الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.