Swing الكلاس JSpinner

مقدمة

الكلاس JSpinner يستخدم لإضافة Spinner في واجهة المستخدم.
الـ Spinner عبارة عن مربع نص يحتوي على قيم جاهزة.
يمكن للمستخدم إختيار إحدى القيم الموجودة فيه بالنقر على الأسهم الملتصقة به, أو باستخدام أسهم لوحة المفاتيح , و يمكنه إدخال القيمة بنفسه.


بناؤه

public class JSpinner
extends JComponent
implements Accessible
	

طريقة التعامل معه

عند التعامل مع الـ Spinner فأنت لا تضع فيه القيم مباشرةً. بل تضعهم في الـ Model الخاصة به.
إذاً سيكون عليك إنشاء كائن من إحدى الكلاسات التي تنفذ الإنترفيس SpinnerModel و وضعه كـ Model لكائن الـ JSpinner.
بعدها يمكنك إضافة العدد الذي تريده من القيم في كائن الـ SpinnerModel و التي ستظهر بدورها في الـ Spinner.


الكلاسات المهمة التي تطبق الإنترفيس SpinnerModel و التي يمكن إستخدامها:

  • SpinnerListModel: يستخدم لتخزين قيم من مصفوفة عادية أو من كائن من إحدى الكلاسات التي تنفذ الإنترفيس List, مثل الكلاس ArrayList.
  • SpinnerNumberModel: يستخدم لتخزين أرقام في الـ Spinner.
  • SpinnerDateModel: يستخدم لتخزين التاريخ أو الوقت في الـ Spinner.

لا تقلق ستفهم كل شيء من الأمثلة.

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

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

الكونستركتور مع تعريفه
public JSpinner() ينشئ كائن من الكلاس JSpinner يمثل Spinner فيه 0 كقيمة أولية نوعها Integer.
هنا الكائن JSpinner يستخدم كائن من الكلاس SpinnerNumberModel كـ Model إفتراضية.
public JSpinner(SpinnerModel model) ينشئ كائن من الكلاس JSpinner يمثل Spinner لها Model محددة. أي لها قيم محددة.
مكان الباراميتر model نمرر كائن من إحدى الكلاسات التي تنفذ الإنترفيس SpinnerModel.

يرمي الإستثناء NullPointerException في حال كان الـ Model فارغاً, أي قيمته تساوي null.

دوال الكلاس JSpinner

الجدول التالي يحتوي على بعض دوال الكلاس JSpinner.

الدالة مع تعريفها
public Ojbect getValue() ترجع القيمة الحالية الظاهرة في كائن الـ JSpinner الذي قام بإستدعائها.
public void setValue(Ojbect value) تستخدم لتحديد القيمة الأولية التي ستظهر في كائن الـ JSpinner الذي قام بإستدعائها.
مكان الباراميتر value نضع القيمة.

ترمي الإستثناء IllegalArgumentException في حال كان نوع القيمة الموضوعة لا يلائم نوع الـ Model المستخدمة.
public void addChangeListener(ChangeListenerener) تستخدم لتنفيذ أوامر معينة عند تغيير قيمة كائن الـ JSpinner الذي قام بإستدعائها.
مكان الباراميتر listener نضع كائن من الكلاس ChangeListener و نفعل بداخله Override لدالة إسمها stateChanged(StateEvent e).

أمثلة شاملة


المثال الأول

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

طريقة إضافة JSpinner في ال JFrame في جافا

شاهد المثال »



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

المثال التالي يعلمك طريقة تنفيذ أوامر في كل مرة يتم فيها تغيير قيمة الـ Spinner.

طريقة تنفيذ أوامر في كل مرة يتم فيها تغيير قيمة ال JSpinner في جافا

شاهد المثال »



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

المثال التالي يعلمك طريقة إنشاء Model لجعل الـ Spinner مخصص فقط لتخزين أرقام. بالإضافة إلى تحديد أقل و أكثر قيمة يمكن وضعها فيه.

طريقة تحديد أقل و أكثر قيمة يمكن وضعها في ال JSpinner في جافا

شاهد المثال »



المثال الربع

المثال التالي يعلمك طريقة إنشاء Model لجعل الـ Spinner مخصص فقط لتخزين مصفوفة من النصوص.

طريقة تحديد أقل و أكثر قيمة يمكن وضعها في ال JSpinner في جافا

شاهد المثال »



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

المثال التالي يعلمك طريقة إنشاء واجهة لإدخال الوقت تحتوي 4 Spinners.
عند النقر على الزر Display Time سيتم إظهار الوقت الذي تم تحديده في Label.

إنشاء واجهة لإدخال الوقت من خلال JSpinner في جافا

شاهد المثال »

الدورات

أدوات مساعدة

أقسام الموقع

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