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

مقالة
09/21/2010

قم بإضافة جديد 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, _
    range As Range, _
    name As String _
) As RadioButton

public static RadioButton AddRadioButton(
    this ControlCollection controls,
    Range range,
    string name
)

المعلمات

controls
النوع: Microsoft.Office.Tools.Excel.ControlCollection
مجموعة لإضافة عنصر تحكم إلى.لا تقم بإدخال هذه معلمة نفسك.عندما تقوم باستدعاء th هو الأسلوب في المجموعة التي تم إرجاعها بواسطة Worksheet.Controlsخاصية (في مشروع المستوى تطبيق) أو WorksheetBase.Controlsخاصية (في مشروع المستوى المستندات)، رقم هو معلمة هو الذي تم توفيره بشكل تلقائي.

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

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

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

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

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

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

استثناءات

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

ملاحظات

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

عنصر تحكم تلقائياً بمغٍِير حجمها عند مغٍِير حجمها النطاق.

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

أمثلة

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

    Private Sub ExcelRangeAddRadioButton()

        Dim RadioButton1 As Microsoft.Office.Tools. _
            Excel.Controls.RadioButton = Me.Controls. _
            AddRadioButton(Me.Range("A1"), "RadioButton1")
        Dim RadioButton2 As Microsoft.Office.Tools. _
            Excel.Controls.RadioButton = Me.Controls. _
            AddRadioButton(Me.Range("A2"), "RadioButton2")

        RadioButton1.Text = "Bold"
        RadioButton2.Text = "Italic"
        RadioButton2.Checked = False

    End Sub

private void ExcelRangeAddRadioButton()
{


    Microsoft.Office.Tools.Excel.Controls.RadioButton
         radioButton1 = this.Controls.AddRadioButton(
         this.Range["A1", missing], "radioButton1");
    Microsoft.Office.Tools.Excel.Controls.RadioButton
         radioButton2 = this.Controls.AddRadioButton(
         this.Range["A2", missing], "radioButton2");
    radioButton1.Text = "Bold";
    radioButton2.Text = "Italic";
    radioButton2.Checked = false;

}

أمن NET Framework.

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