Swingالكلاس JTable
- مقدمة
- كونستركتورات الكلاس JTable
- دوال الكلاس JTable
- أمثلة شاملة
مقدمة
الكلاس JTable يستخدم لإضافة جدول (Table) في واجهة المستخدم.
بناؤه
طريقة التعامل معه
عند التعامل مع الـ Table فأنت لا تضع فيه القيم مباشرةً. بل تضع القيم في الـ Model الخاصة به.
إذاً سيكون عليك إنشاء كائن من إحدى الكلاسات التي تنفذ الإنترفيس TableModel و وضعه كـ Model لكائن الـ JTable.
بعدها يمكنك إنشاء مصفوفتين, الأولى تكون ذات بعد واحد تضع فيها أسماء أعمدة الجدول. و الثانية تكون ذات بعدين تضع فيها قيم الجدول.
في الأخير تضع كلا المصفوفتين في الـ Model و عندها ستظهر عناصرهما مباشرةً في الجدول.
و يمكنك وضع الـ Table بداخل JScrollPane لجعلها تظهر Scroll Bar عند الحاجة.
لا تقلق ستفهم كل شيء من الأمثلة.
مصطلحات تقنية
| المصطلح | معناه |
|---|---|
| Table | تعني جدول. و هو يتألف من أعمدة و أسطر. |
| Row | عبارة عن سطر في الجدول. |
| Column | عبارة عن عامود في الجدول. |
| Cell | عبارة عن خلية في الجدول. و هي عبارة عن كائن موجود في سطر و عمود محدد في الجدول. كل خلية تمثل قيمة في الجدول. |
كونستركتورات الكلاس JTable
الجدول التالي يحتوي على كونستركتورات الكلاس JTable.
| الكونستركتور مع تعريفه | |
|---|---|
| 1 | public JTable() ينشئ كائن من الكلاس JTable يمثل جدول فارغ. |
| 2 | public JTable(int numRows, int numColumns)
ينشئ كائن من الكلاس JTable يمثل جدول له عدد محدد من الأعمدة و الأسطر.
|
| 3 | public JTable(Object[][] rowData, Object[] columnNames)
ينشئ كائن من الكلاس JTable يمثل جدول مجهز بأسماء الجدوال و البيانات.
|
| 4 | public JTable(TableModel model)
ينشئ كائن من الكلاس JTable يمثل جدول مجهز بأسماء الجدوال و البيانات. مكان الباراميتر model نضع كائن من إحدى الكلاسات التي تنفذ الإنترفيس TableModel و الذي بدوره يحتوي على جميع المعلومات التي ستظهر في الجدول. |
| 5 | public JTable(Vector rowData, Vector columnNames)
ينشئ كائن من الكلاس JTable يمثل جدول مجهز بأسماء الجدوال و البيانات.
|
دوال الكلاس JTable
الجدول التالي يحتوي على بعض دوال الكلاس JTable.
| الدالة مع تعريفها | |
|---|---|
| 1 | public Object getValue(int row, int column)
ترجع قيمة موجودة في كائن الـ JTable الذي قام بإستدعائها ككائن نوعه Object.
|
| 2 | public void SetValue(Object newValue, int row, int column)
تضع قيمة جديدة مكان قيمة كانت أصلاً موجودة في كائن الـ JTable الذي قام بإستدعائها.
|
| 3 | public int getRowCount() ترجع عدد الأسطر الموجودة في كائن الـ JTable الذي قام بإستدعائها. |
| 4 | public int getColumnCount() ترجع عدد الأعمدة الموجودة في كائن الـ JTable الذي قام بإستدعائها. |
| 5 | public int getSelectedColumn()
ترجع رقم يمثل Index أول عامود قام المستخدم بتحديده في كائن الـ JTable الذي قام بإستدعائها. و ترجع 1- في حال لم يتم تحديد أي عامود. |
| 6 | public int[] getSelectedColumns()
ترجع مصفوفة من الأرقام تمثل أرقام الـ Indices لجميع الأعمدة التي قام المستخدم بتحديدها في كائن الـ JTable الذي قام بإستدعائها. و ترجع مصفوفة فارغة, أي 0 في حال لم يتم تحديد أي عامود. |
| 7 | public int getSelectedRow()
ترجع رقم يمثل Index أول سطر قام المستخدم بتحديده في كائن الـ JTable الذي قام بإستدعائها. و ترجع 1- في حال لم يتم تحديد أي سطر. |
| 8 | public int[] getSelectedRows()
ترجع مصفوفة من الأرقام تمثل أرقام الـ Indices لجميع الأسطر التي قام المستخدم بتحديدها في كائن الـ JTable الذي قام بإستدعائها. و ترجع مصفوفة فارغة, أي 0 في حال لم يتم تحديد أي سطر. |
| 9 | public boolean isCellSelected(int row, int column)
ترجع true إذا كان رقم السطر و العامود اللذين تم تمريرهما كـ Arguments للدالة يشيران إلى Cell قد تم تحديدها في كائن الـ JTable الذي قام بإستدعائها.
|
| 10 | public void setModel(TabelModel model)
تستخدم لتحديد Model كائن الـ JTable الذي قام بإستدعائها. مكان الباراميتر model نضع كائن من إحدى الكلاسات التي تنفذ الإنترفيس TabelModel. ترمي الإستثناء IllegalArgumentException في حال كان كائن الـ dataModel فارغاً, أي قيمته تساوي null. |
| 11 | public TabelModel getModel() ترجع نسخة من كائن الـ TableModel الذي يستخدمه كائن الـ JTable الذي قام بإستدعائها. |
أمثلة شاملة
المثال الأول
المثال التالي يعلمك طريقة إنشاء جدول و إعطائه قيم مباشرةً عند الإنشاء ثم ضافته في النافذة.
المثال الثاني
المثال التالي يعلمك طريقة جعل المستخدم يدخل البيانات في الجدول, بالإضافة إلى جعله قادر على حذف البيانات التي أدخلها.
المثال الثالث
المثال التالي يعلمك طريقة الحصول على جميع القيم التي قام المستخدم بتحديدها في الجدول عند النقر على زر.
المثال الرابع
المثال التالي يعلمك طريقة الحصول على جميع القيم التي قام المستخدم بتحديدها في الجدول.
المثال الخامس
المثال التالي يعلمك الطرق التي يمكن فيها جعل المستخدم يقوم باختيار القيم الموجودة في الجدول.
