اقرأ في هذا المقال
- ما هو الكلاس JTextArea في Java Swing
- أهم الدوال الخاصة بالكلاس JTextArea
- أهم الكونستركتورات الخاصة بالكلاس JTextArea
ما هو الكلاس JTextArea في Java Swing:
يُعد الكلاس (JTextArea) من الكلاسات المهمة في (Java Swing) والذي يستخدم لإضافة مربع نص كبير، ويتكون من أكثر من سطر (Text Area) في واجهة المستخدم (Graphical user interface)، وهناك العديد من الدوال والكونستركتورات الخاصة بهذا الكلاس والتي سنتعرف عليها في هذا المقال.
أهم الدوال الخاصة بالكلاس JTextArea:
الجدول التالي يحتوي على أهم الدوال الخاصة بالكلاس (JTextArea):
| الدالة | الاستخدام |
| ()public String getText | تقوم هذه الدالة بإرجاع نص كائن (JTextArea) الذي قام باستدعائها كـ (String). |
| publicvoidsetText(String text) | تستخدم هذه الدالة لتبديل نص كائن ـ JTextArea الذي قام باستدعائها، حيث مكان الباراميتر (text) يتم وضع النص الجديد. |
| ()publicintgetRows | تقوم هذه الدالة بإرجاع رقم يمثل عدد الأسطر الظاهرة في كائن (JTextArea) الذي قام باستدعائها. |
| publicvoidsetRows(int rowsNumber) | تستخدم هذه الدالة لتحديد عدد أسطر كائن الـ (JTextArea) الذي قام باستدعائها، حيث مكان الباراميتر (rowsNumber) نضع عدد الأسطر الجديد. |
| ()publicintgetLineCount | تقوم هذه الدالة بإرجاع رقم يمثل عدد جمع الأسطر الموجودة في كائن (JTextArea) الذي قام باستدعائها سواء كانت ظاهرة أو غير ظاهرة. |
| public void setCols(int columnsNumber) | تستخدم هذه الدالة لتحديد عدد أكبر عدد من الأحرف التي يمكن إدخالها في كل سطر في كائن (JTextArea) الذي قام باستدعائها، حيث مكان الباراميتر (columnsNumber) نضع عدد الأحرف الجديد. |
| public void setLineWrap(boolean wrapLine) | تستخدم هذه الدالة لجعل محتوى كائن (JTextArea) الذي قام باستدعائها يظهر على سطر جديد في حال كان عدد الأحرف الموجود في السطر أكبر من عدد الأحرف التي يمكن وضعها داخله، حيث مكان الباراميتر (wrapLine) نضع القيمة (true) لتفعيل هذه الخاصية. |
| publicvoidinsert(String str, int pos) | تستخدم هذه الدالة لإضافة نص في مكان محدد في كائن (JTextArea) الذي قام باستدعائها حيث:
|
| public void append(String str) | تستخدم هذه الدالة لإضافة النص الذي يتم تمريره لها مكان الباراميتر (str) في آخر النص الموجود في كائن الـ (JTextArea) الذي قام باستدعائها. |
| public void addActionListener(ActionListener al) | تستخدم هذه الدالة لتنفيذ أوامر معينة عند النقر في كائن (JTextArea) الذي قام باستدعائها. |
| public void removeActionListener(ActionListener al) | تستخدم هذه الدالة لتجنب تنفيذ أوامر الدالة (()addActionListener) من جديد عند النقر بداخل كائن الـ (JTextArea) الذي قام باستدعائها. |
أهم الكونستركتورات الخاصة بالكلاس JTextArea:
| Constructor | الاستخدام |
| ()publicJTextArea | يقوم هذا الكونستركتور بإنشاء كائن من الكلاس (JTextArea) ويمثل (Text Area) فارغ. |
| publicJTextArea(String text) | يقوم هذا الكونستركتور كائن من الكلاس JTextArea يمثل Text Area فيه نص، حيث مكان الباراميتر (text) يتم تمرير النص الذي نريد وضعه بداخل الـ (Text Area). |
| publicJTextArea(int rows, int columns) | يقوم هذا الكونستركتور بإنشاء كائن من الكلاس (JTextArea) والذي يمثل (Text Area) له عدد محدد من الأسطر والأحرف. |
