ControlExtensions.AddComboBox أسلوب (ControlCollection, Range, String)
قم بإضافة جديد ComboBoxعنصر تحكم إلى ورقة عمل في النطاق المحدد.
مساحة الاسم: Microsoft.Office.Tools.Excel
التجميع: Microsoft.Office.Tools.Excel.v4.0.Utilities (في Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
بناء الجملة
'إقرار
<ExtensionAttribute> _
Public Shared Function AddComboBox ( _
controls As ControlCollection, _
range As Range, _
name As String _
) As ComboBox
public static ComboBox AddComboBox(
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.ComboBox
ComboBoxعنصر تحكم تمت إضافته إلى ControlCollectionالمثيل.
ملاحظة على الاستخدام
في Visual Basic و#C، يمكنك استدعاء هذا الأسلوب كأسلوب مثيل على أي كائن من النوع ControlCollection. عند استخدام بناء جملة أسلوب مثيل لاستدعاء مثل هذا الأسلوب، احذف المعلمة الأولى. لمزيد من المعلومات، راجع أساليب ملحق (Visual Basic) أو أساليب ملحق (C# البرمجة الدليل).
استثناءات
| استثناء: | شرط |
|---|---|
| ArgumentNullException | وسيطة اسم أو النطاق هو nullمرجع خالٍ (لا شيء في Visual Basic)، أو وسيطة "اسم" الطول الصفرية. |
| ControlNameAlreadyExistsException | عنصر تحكم بنفس الاسم هو موجود بالفعل في ControlCollectionالمثيل. |
| InvalidRangeException | النطاق الذي تم تحديده هو غير صالح. لا يمكن استخدام نطاقات multi-مساحة. يجب أن يكون النطاق ورقة عمل نفسها ك ControlCollectionمثيل. |
ملاحظات
AddComboBoxأسلوب تمكنك من إضافة ComboBoxالكائنات إلى النهاية ControlCollection. إلى إزالة ComboBoxالذي تم مسبقاً إضافته برمجياً، استخدم Removeالأسلوب.
عنصر تحكم تلقائياً بمغٍِير حجمها عند مغٍِير حجمها النطاق.
أمثلة
يلي تعليمات برمجية المثال يضيف على ComboBoxعنصر التحكم إلى خلايا A1 حتى B1، إضافة عنصرين لمربع التحرير والسرد وثم بتحديد عنصر أول. إلى لاستخدام هذا المثال، قم بتشغيلها من Sheet1الفئة في مشروع المستوى مستند.
Private Sub ExcelRangeAddComboBox()
Dim ComboBox1 As Microsoft.Office.Tools.Excel. _
Controls.ComboBox = Me.Controls.AddComboBox( _
Me.Range("A1", "B1"), "ComboBox1")
ComboBox1.Items.Add("First Item")
ComboBox1.Items.Add("Second Item")
ComboBox1.SelectedIndex = 0
End Sub
private void ExcelRangeAddComboBox()
{
Microsoft.Office.Tools.Excel.Controls.ComboBox
comboBox1 = this.Controls.AddComboBox(
this.Range["A1", "B1"], "comboBox1");
comboBox1.Items.Add("First Item");
comboBox1.Items.Add("Second Item");
comboBox1.SelectedIndex = 0;
}
أمن NET Framework.
- الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.