ما هو الكلاس JList في Java Swing وما هي أهم الدوال المستخدمه معه

اقرأ في هذا المقال


ما هو الكلاس JList في Java Swing؟

يعد الكلاس (JList) واحد من الكلاسات التي تستخدم في (Java Swing) لإضافة قائمة (List) في واجهة المستخدم (Graphical User Interface)، حيث عند التعامل مع القائمة فإنه لا يتم وضع فيها العناصر بشكل مباشر بل يتم وضع العناصر في ال (Model) الخاصة بها، حيث يجب على المستخدم إنشاء كائن من الكلاس (DefaultListModel) ووضعه كـ (Model) لكائن الـ (JList).

أهم الدوال التي تستخدم مع الكلاس JList في Java Swing:

الجدول التالي يحتوي على أهم الدوال الخاصة بالكلاس JList:

الدالةالاستخدام
publicvoidaddListSelectionListener(ListSelectionListener listener)تستخدم هذه الدالة لتنفيذ أوامر معينة عند النقر على أي خيار موجود في كائن الـ (JList) الذي قام باستدعائها.
()public E getSelectedValueتقوم هذه الدالة بإرجاع قيمة العنصر الذي قام المستخدم باختياره في كائن الـ  (JList) الذي قام باستدعائها، وعند قيام  المستخدم باختيار أكثر من عنصر، فيتم إرجاع قيمة العنصر الذي يملك أصغر (index) بينهم، وفي حال لم يقم المستخدم باختيار أي عنصر فيتم إرجاع القيمة (null).
()publicintgetSelectedIndexتقوم هذه الدالة بإرجاع رقم يمثل (index) العنصر الذي قام المستخدم باختياره في الكائن الخاص بـ (JList) الذي قام باستدعائها.
()publicint[]getSelectedIndicesتقوم هذه الدالة بإرجاع مصفوفة أرقام حيث كل رقم فيها يمثل (index) عنصر من العناصر التي قام المستخدم باختيارها في الكائن من نوع (JList) الذي قام باستدعائها.
publicvoidsetModel(ListModel<E> model)تستخدم هذه الدالة لتحديد (Model) لكائن الـ (JList) الذي قام باستدعائها، حيث مكان الباراميتر (model) يتم وضع كائن من الكلاس (ListModel).
()public ListModel<E> getModel
تقوم هذه الدالة بإرجاع نسخة من كائن الـ (ListModel) الذي يستخدمه كائن الـ (JList) الذي قام باستدعائها.
publicvoidsetLayoutOrientation(int layoutOrientation)
تستخدم هذه الدالة لتحديد طريقة ظهور العناصر بداخل كائن الـ (JList) الذي قام باستدعائها.

أهم الكونستركتورات الخاصة بالكلاس JList:

الجدول التالي يحتوي على كونستركتورات الكلاس (JList):

Constructorالاستخدام
()publicJListيقوم هذا الكونستركتور بإنشاء كائن من الكلاس (JList)، حيث يمثل قائمة فارغة أي أنها لا تحتوي أي عنصر.
publicJList(E[] listData)يقوم هذا الكونستركتور بإنشاء كائن من الكلاس (JList)، حيث يمثل قائمة فيها مجموعة من الخيارات الجاهزة.
publicJList(ListModel<E> dataModel)يقوم هذا الكونستركتور بإنشاء كائن من الكلاس (JList)، حيث يمثل قائمة فيها خيارات جاهزة، ومكان الباراميتر (dataModel) يتم تمرير كائن من الكلاس (ListModel).

المصدر: Java Swing | JList with examplesJava JListSWING - JList ClassJList basic tutorial and examples


شارك المقالة: