Swingالكلاس `JTable`

مقدمة
كونستركتورات الكلاس JTable
دوال الكلاس JTable
أمثلة شاملة

مقدمة

الكلاس JTable يستخدم لإضافة جدول (Table) في واجهة المستخدم.

بناؤه

public class JTable
extends JComponent
implements TableModelListener, Scrollable, TableColumnModelListener,SelectionListener, CellEditorListener, Accessible, RowSorterListener 

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

عند التعامل مع الـ 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` يمثل جدول له عدد محدد من الأعمدة و الأسطر. مكان الباراميتر `numRows` نضع رقم يمثل عدد الأسطر التي ستظهر في الجدول. مكان الباراميتر `numColumns` نضع رقم يمثل عدد الأعمدة التي ستظهر في الجدول.
3	`public JTable(Object[][] rowData, Object[] columnNames)` ينشئ كائن من الكلاس `JTable` يمثل جدول مجهز بأسماء الجدوال و البيانات. مكان الباراميتر `rowData` نضع مصفوفة ذات بعدين تحتوي على البيانات التي ستظهر في الجدول. مكان الباراميتر `columnNames` نضع مصفوفة ذات بعد واحد تحتوي على أسماء الجداول التي ستظهر في الجدول.
4	`public JTable(TableModel model)` ينشئ كائن من الكلاس `JTable` يمثل جدول مجهز بأسماء الجدوال و البيانات. مكان الباراميتر `model` نضع كائن من إحدى الكلاسات التي تنفذ الإنترفيس `TableModel` و الذي بدوره يحتوي على جميع المعلومات التي ستظهر في الجدول.
5	`public JTable(Vector rowData, Vector columnNames)` ينشئ كائن من الكلاس `JTable` يمثل جدول مجهز بأسماء الجدوال و البيانات. مكان الباراميتر `rowData` نضع كائن من الكلاس `Vector` يحتوي على البيانات التي ستظهر في الجدول. مكان الباراميتر `columnNames` نضع كائن من الكلاس `Vector` يحتوي على أسماء الجداول التي ستظهر في الجدول.

دوال الكلاس `JTable`

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

الدالة مع تعريفها
1	`public Object getValue(int row, int column)` ترجع قيمة موجودة في كائن الـ `JTable` الذي قام بإستدعائها ككائن نوعه `Object`. مكان الباراميتر `row` نضع Index السطر الذي يحتوي على القيمة. مكان الباراميتر `column` نضع Index العامود الذي يحتوي على القيمة.
2	`public void SetValue(Object newValue, int row, int column)` تضع قيمة جديدة مكان قيمة كانت أصلاً موجودة في كائن الـ `JTable` الذي قام بإستدعائها. مكان الباراميتر `newValue` نضع القيمة الجديدة. مكان الباراميتر `row` نضع Index السطر الذي يحتوي على القيمة. مكان الباراميتر `column` نضع Index العامود الذي يحتوي على القيمة.
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` الذي قام بإستدعائها. مكان الباراميتر `row` نضع Index السطر الذي يشير على الـ Cell. مكان الباراميتر `column` نضع Index العامود الذي يشير للـ Cell.
10	`public void setModel(TabelModel model)` تستخدم لتحديد Model كائن الـ `JTable` الذي قام بإستدعائها. مكان الباراميتر `model` نضع كائن من إحدى الكلاسات التي تنفذ الإنترفيس `TabelModel`. ترمي الإستثناء IllegalArgumentException في حال كان كائن الـ `dataModel` فارغاً, أي قيمته تساوي `null`.
11	`public TabelModel getModel()` ترجع نسخة من كائن الـ `TableModel` الذي يستخدمه كائن الـ `JTable` الذي قام بإستدعائها.