إعلان
تعلم الآن
الدرس التالي» »الدرس السابق

JavaFX الكلاس ComboBox

مقدمة

الكلاس ComboBox يستخدم لإضافة قائمة منسدلة (Combo Box) في واجهة المستخدم و هو يشبه الكلاس choiceBox.


بناء الكلاس ComboBox

public class ComboBox<T>
extends ComboBoxBase<T>

معلومة تقنية

كل كائن ComboBox تنشئه يتم ربطه بكائن من كلاس إسمه ObservableList.
كائن الـ ObservableList هو الذي تتخزن فيه الخيارات التي تظهر عند فتح الـ ComboBox.
إذاً عند النقر على الـ ComboBox فإنه يظهر العناصر المخزنة في كائن الـ ObservableList المرتبط به.

لهذا السبب عندما تريد أن تتعامل مع محتوى الـ ComboBox عليك أن تتعامل مع الـ ObservableList الخاصة به.

الفرق بين الـ ComboBox و الـ ChoiceBox

  • في الـ ComboBox يمكن جعل المستخدم قادر على اختيار قيمة من القائمة الموجودة فيه أو إدخال قيمة جديدة فيه.
  • في الـ ComboBox عند إظهار محتواه فإنه يظهر القائمة تحته و يكون حجمها مطابق له.
  • في الـ ComboBox يمكن وضع لائحة (List) بداخله. أي يمكن وضع لائحة بداخل قائمة الـ ComboBox.

كونستركتورات الكلاس ComboBox

الجدول التالي يحتوي على كونستركتورات الكلاس ComboBox.

الكونستركتور مع تعريفه
public ComboBox() ينشئ كائن من الكلاس ComboBox يمثل Choice Box فارغة, أي لا تحتوي أي عنصر.
public ComboBox(ObservableList<E> items) ينشئ كائن من الكلاس ComboBox يمثل Choice Box فيها خيارات جاهزة.
مكان الباراميتر items نمرر كائن من الكلاس ObservableList.
عناصر الكائن ObservableList هي التي ستظهر كخيارات في القائمة.

دوال الكلاس ComboBox

الجدول التالي يحتوي على دوال الكلاس ComboBox الأكثر إستخداماً.

الدالة مع تعريفها
public final void setTranslateX(double value) تستخدم لتحديد مكان كائن الـ ComboBox الذي قام باستدعائها أفقياً.
مكان الباراميتر value نضع رقم يمثل كم Pixel سيتم إزاحته من اليسار إلى اليمين.
public final void setTranslateY(double value) تستخدم لتحديد مكان كائن الـ ComboBox الذي قام باستدعائها عامودياً.
مكان الباراميتر value نضع رقم يمثل كم Pixel سيتم إزاحته من الأعلى إلى الأسفل.
public void setPrefSize(double prefWidth, double prefHeight) تستخدم لتحديد حجم كائن الـ ComboBox الذي قام باستدعائها.

  • مكان الباراميتر prefWidth نضع رقم يمثل عرض الـ ComboBox بالـ Pixel.
  • مكان الباراميتر prefHeight نضع رقم يمثل طول الـ ComboBox بالـ Pixel.
public final void setDisable(boolean value) تستخدم لجعل كائن الـ ComboBox الذي قام باستدعائها يبدو غير مفعّل, أي يصبح لونه باهتاً و غير قابل للنقر عليه.
مكان الباراميتر value نضع القيمة true لجعله غير مفعّل.
public final SingleSelectionModel<T> getSelectionModel() ترجع كائن من الكلاس SingleSelectionModel يمثل الخيار الذي تم النقر عليه بداخل كائن الـ ComboBox.
من خلال الكائن الذي ترجعه هذه الدالة يمكنك معرفة الخيار المختار في الـ ComboBox, معرفة رقم الـ index الخاص به, معرفة الخيار التالي بعده في الـ ComboBox, معرفة أول و آخر عنصر في الـ ComboBox, معرفة ما إذا كان الـ ComboBox فارغ, تحديد خيار آخر غير الذي قام المستخدم باختياره إلخ..
public final ObservableList<T> getItems() ترجع كائن الـ ObservableList المرتبط بكائن الـ ComboBox الذي قام باستدعائها.
من خلال الكائن الذي ترجعه هذه الدالة يمكنك معرفة عدد الخيارات الموجودة في الـ ComboBox, إضافة خيار أو أكثر فيه, حذف خيار أو أكثر منه, البحث فيه, فلترة الخيارات التي نريدها أن تظهر إلخ..
public final void setEditable(boolean value) تستخدم لجعل المستخدم قادر على اختيار قيمة من كائن الـ ComboBox الذي قام باستدعائها و بنفس الوقت يمكنه إدخال قيمة جديد فيها.
مكان الباراميتر value نضع القيمة true لجعله المستخدم قادر على إدخال قيمة فيها.
public final void setStyle(String value) تستخدم لتعديل تصميم كائن الـ ComboBox الذي قام بإستدعائها.
مكان الباراميتر value يمكنك تمرير إسم و قيمة أي خاصية تريد تعديلها في كائن الـ ComboBox بأسلوب لغة CSS لإظهاره بالشكل الذي تريده.

أمثلة شاملة


المثال الأول

المثال التالي يعلمك طريقة إنشاء كائن من الكلاس ComboBox و إضافته في النافذة.

طريقة إضافة ComboBox في javafx

شاهد المثال »



المثال الثاني

المثال التالي يعلمك طريقة إنشاء كائن من الكلاس ComboBox يحتوي على عناصر.
ملاحظة: هنا عند تشغيل البرنامج, الـ ComboBox تظهر فارغة إلى أن يقوم المستخدم بالنقر على أي خيار موجود فيها.

طريقة إضافة عناصر في ال ComboBox في javafx

شاهد المثال »



المثال الثالث

المثال التالي يعلمك طريقة جعل أول عنصر في الـ ComboBox مختاراً بشكل إفتراضي.
ستتعلم أيضاً كيف تضيف خط فاصل بين العناصر.
ملاحظة: هنا عند تشغيل البرنامج, سيظهر في الـ ComboBox أول خيار موجود فيها.

طريقة جعل أول عنصر في ال ComboBox مختاراً بشكل إفتراضي في javafx

شاهد المثال »



المثال الرابع

المثال التالي يعلمك طريقة معرفة العنصر الذي قام المستخدم باختياره من ضمن العناصر الموجودة في ComboBox عند النقر على Button.

طريقة معرفة العنصر الذي قام المستخدم باختياره من ضمن العناصر الموجودة في ComboBox عند النقر على زر في javafx

شاهد المثال »



المثال الخامس

المثال التالي يعلمك طريقة تنفيذ أوامر عند تغيير القيمة المختارة في كائن الـ ComboBox.

طريقة تنفيذ أوامر عند تغيير القيمة المختارة في الـ ComboBox

شاهد المثال »



المثال السادس

المثال التالي يعلمك طريقة جعل المستخدم يقوم بإضافة أو حذف عناصر في كائن الـ ComboBox.
بالإضافة إلى إظهار عدد جميع العناصر الموجودة فيه.

طريقة جعل المستخدم يقوم بإضافة أو حذف عناصر في الـ ComboBox و إظهار عدد جميع العناصر الموجودة فيه في javafx

شاهد المثال »



المثال السابع

المثال التالي يعلمك طريقة جعل المستخدم قادر على اختيار قيمة أو إدخال قيمة في كائن الـ ComboBox.
بالإضافة إلى إظهار القيمة التي قام باختيارها أو إدخالها فيه.

طريقة جعل المستخدم قادر على إختيار قيمة أو إدخال قيمة في الـ ComboBox

شاهد المثال »

الدرس التالي» »الدرس السابق

الدورات

اللغة الإنجليزية
البرمجة للمبتدئين
قواعد البيانات
لغة HTML
لغة CSS
لغة Python
لغة Java
لغة C++
الإطار Swing
الإطار JavaFX
أساسيات الحاسوب
الخوارزميات
الخوارزميات و هياكل البيانات
الكتابة على الكيبورد
القرآن الكريم و الأذكار

أدوات مساعدة

محرر الويب
محرر البرمجة للمبتدئين
أداة إختيار الألوان
أداة رسم الأشكال بواسطة CSS
محول الوحدات
محلل عناوين الشبكات

أقسام الموقع

دورات
مقالات كتب مشاريع أسئلة