ما هو الكلاس JTable في java swing وما أهم الدوال المستخدمة معه

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


ما هو الكلاس JTable في java swing:

يُعد الكلاس (JTable) من الكلاسات الرئيسية في جافا سوينغ (Java Swing)، ويستخدم هذا الكلاس لإضافة جدول (Table) في واجهة المستخدم (Graphical User Interface) وهناك العديد من الدوال والكونستركتورات التي تستخدم مع هذا الكلاس، حيث يتم إنشاء كائن من إحدى الكلاسات ويتم وضعه كـ (Model) لكائن الـ (JTable).

أهم الدوال الكلاس المستخدمة مع الكلاس JTable:

الدالةالاستخدام
public Object getValue(int row, int column)تقوم بإرجاع القيمة الموجودة داخل كائن الـ (JTable) الذي قام باستدعائها ككائن من نوع (Object) حيث:
  • مكان (row) يتم وضع رقم (Index) السطر الذي يحتوي على القيمة.
  • مكان (column) يتم وضع  رقم العمود الذي يحتوي على القيمة.
publicvoidSetValue(ObjectnewValue, int row, int column)يتم وضع قيمة جديدة مكان قيمة كانت  موجودة سابقاً في كائن الـ ( JTable) الذي قام باستدعائها حيث:
  • مكان الباراميتر “newValue” نضع القيمة الجديدة.
  • مكان (row) يتم وضع (Index) السطر الذي يحتوي على القيمة.
  • مكان (column) يتم وضع رقم العمود الذي يحتوي على القيمة.
()publicintgetRowCountتقوم هذه الدالة  بإرجاع عدد الأسطر الموجودة في كائن الـ (JTable) الذي قام باستدعائها.
()publicintgetColumnCountتقوم هذه الدالة بإرجاع عدد الأعمدة الموجودة في كائن الـ (JTable) الذي قام باستدعائها.
()publicintgetSelectedColumnتقوم بإرجاع رقم يمثل (Index) العمود الأول الذي قام المستخدم بتحديده في كائن الـ (JTable) الذي قام باستدعائها.
()public int[]getSelectedColumnsتقوم هذه الدالة بإرجاع مصفوفة فارغة أي (0) في حال لم يتم تحديد أي عمود، وتقوم بإرجاع مصفوفة من الأرقام التي تمثل أرقام كافة الأعمدة التي قام المستخدم بتعيينها في كائن الـ (JTable) الذي قام باستدعائه.
()public intgetSelectedRowتقوم هذه الدالة بإرجاع رقم يمثل (Index) أول سطر يقوم المستخدم بتعينه في كائن الـ (JTable) الذي قام باستدعائها.
()publicint[]getSelectedRows
تقوم بإرجاع مصفوفة من الأرقام تمثل أرقام جميع الأسطر التي يقوم المستخدم بتعينها  في كائن الـ (JTable) الذي قام باستدعائها.
public booleanisCellSelected(int row, int column)تقوم بإرجاع قيمة (true) إذا كان رقم السطر و العمود اللذين تم تمريرهما كـ Arguments للدالة حيث:
  • مكان (row) يتم وضع رقم السطر الذي يشير على الـ (Cell).
  • مكان (column) يتم وضع رقم العمود الذي يشير للـ (Cell).

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

Constructorالاستخدام
()publicJTableيقوم بإنشاء كائن من الكلاس (JTable) والذي يمثل جدول فارغ.
publicJTable(int numRows, int numColumns)يقوم هذا الكونستركتور بإنشاء كائن من الكلاس (JTable) والذي يمثل جدول له عدد معين من الأعمدة و الأسطر.
publicJTable(Object[][] rowData, Object[] columnNames)يقوم بإنشاء كائن من الكلاس (JTable) والذي يتعين من خلال جدول مجهز بأسماء الجداول والبيانات.

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