اقرأ في هذا المقال
- ما هو الكلاس JList في Java Swing؟
- أهم الدوال التي تستخدم مع الكلاس JList في Java Swing
- أهم الكونستركتورات الخاصة بالكلاس JList
ما هو الكلاس 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). |
