المحتوى الرئيسي

مفهوم صندوق التحرير والسرد ComboBox

صندوق التحرير والسرد (ComboBox) هو أداة تحكم تجمع بين خصائص TextBox وListBox في أداة واحدة؛ فهو يعرض قائمة منسدلة من العناصر لا تظهر كاملة إلا عند الضغط على السهم الجانبي، وقد يسمح أيضًا للمستخدم بكتابة قيمة غير موجودة بالقائمة حسب نمط العرض المختار.

الفرق بين ComboBox وListBox

الخاصية DropDownStyle

تحدد نمط عمل الصندوق، ولها ثلاث قيم رئيسية:

• Simple: تظهر القائمة كاملة دائمًا مثل ListBox، مع إمكانية الكتابة في الجزء العلوي.
• DropDown (الافتراضية): قائمة منسدلة، ويمكن للمستخدم أيضًا كتابة نص غير موجود بالقائمة.
• DropDownList: قائمة منسدلة، لكن لا يمكن للمستخدم كتابة أي نص؛ يجب عليه الاختيار من العناصر الموجودة فقط.

الخاصية Items

مثل ListBox تمامًا، تمثّل مجموعة العناصر الظاهرة في القائمة، وتُضاف بنفس الطريقة:

ComboBox1.Items.Add("الأول الإعدادي")
ComboBox1.Items.Add("الثاني الإعدادي")
ComboBox1.Items.Add("الثالث الإعدادي")

الخاصيتان SelectedItem وSelectedIndex

تعملان بنفس منطق ListBox تمامًا: SelectedItem تعيد قيمة العنصر المختار، وSelectedIndex تعيد رقم ترتيبه (يبدأ من صفر، وتكون -1 إذا لم يُختَر شيء):

Dim gradeChosen As String
gradeChosen = ComboBox1.SelectedItem.ToString()

الخاصية Text

في ComboBox، تحمل خاصية Text القيمة الظاهرة حاليًّا في الصندوق، سواء كانت مختارة من القائمة أو مكتوبة يدويًّا (في حالة DropDownStyle = DropDown):

ComboBox1.Text = "الثالث الإعدادي"

خصائص أخرى مهمة

• Sorted: ترتيب العناصر أبجديًّا تلقائيًّا (Boolean).
• Name: الاسم البرمجي، مثل cboGrade.

أسئلة للمراجعة

1. اذكر فرقين جوهريين بين ComboBox وListBox.
2. ما القيمة التي تضبطها لخاصية DropDownStyle لمنع المستخدم من كتابة أي نص جديد؟
3. اكتب كودًا يضيف ثلاثة أيام دراسية إلى ComboBox1: “السبت”، “الأحد”، “الاثنين”.
4. اكتب سطر كود يقرأ القيمة المختارة حاليًّا من ComboBox1 ويخزنها في متغير نصي.
5. لماذا يُفضَّل استخدام ComboBox بدلًا من ListBox عندما تكون مساحة الواجهة محدودة؟