JavaFX الكلاس CheckBox

مقدمة

الكلاس CheckBox يستخدم لإضافة (Check Box) في واجهة المستخدم.
الـ Check Box يستخدم في العادة عند وضع عدة خيارات ( Options ) للمستخدم مع إمكانية أن يختار منها ما يشاء.


بناء الكلاس CheckBox

public class CheckBox
extends ButtonBase
	

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

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

الكونستركتور مع تعريفه
public CheckBox() ينشئ كائن من الكلاس CheckBox يمثل Check Box لا يوجد بجانبه نص.
public CheckBox(String text) ينشئ كائن من الكلاس CheckBox يمثل Check Box بجانبه نص.
مكان الباراميتر text نمرر النص الذي نريد وضعه بجانب الـ Check Box.

دوال الكلاس CheckBox

الجدول التالي يحتوي على دوال الكلاس CheckBox الأكثر إستخداماً.

الدالة مع تعريفها
public String getText() ترجع نص كائن الـ CheckBox الذي قام بإستدعائها كنص.
public void setText(String text) تستخدم لتبديل نص كائن الـ CheckBox الذي قام بإستدعائها.
مكان الباراميتر text نضع النص الجديد.
public final void setTextFill(Paint value) تستخدم لتحديد لون نص كائن الـ CheckBox الذي قام بإستدعائها.
مكان الباراميتر value نضع كائن من إحدى الكلاسات التي ترث من الكلاس Paint و التي يمكن إستخدامها لتحديد درجة اللون.
public final void setBackground(Background value) تستخدم لوضع لون أو صورة كخلفية لكائن الـ CheckBox الذي قام بإستدعائها.
مكان الباراميتر value نضع كائن من الكلاس Background يشير إلى درجة اللون أو الصورة التي سيتم وضعها كخلفية.
public final void setFont(Font newFont) تستخدم لتحديد حجم و نوع خط كائن الـ CheckBox الذي قام بإستدعائها.
مكان الباراميتر newFont نضع كائن من الكلاس Font يمثل خصائص الخط الجديد.
public final void setTranslateX(double value) تستخدم لتحديد مكان كائن الـ CheckBox الذي قام باستدعائها أفقياً.
مكان الباراميتر value نضع رقم يمثل كم Pixel سيتم إزاحته من اليسار إلى اليمين.
public final void setTranslateY(double value) تستخدم لتحديد مكان كائن الـ CheckBox الذي قام باستدعائها عامودياً.
مكان الباراميتر value نضع رقم يمثل كم Pixel سيتم إزاحته من الأعلى إلى الأسفل.
public void setPrefSize(double prefWidth, double prefHeight) تستخدم لتحديد حجم كائن الـ CheckBox الذي قام باستدعائها.

  • مكان الباراميتر prefWidth نضع رقم يمثل عرض الـ CheckBox بالـ Pixel.
  • مكان الباراميتر prefHeight نضع رقم يمثل طول الـ CheckBox بالـ Pixel.
public final void setContentDisplay(ContentDisplay value) تستخدم لتحديد مكان ظهور الأيقونة التي تم إضافتها لكائن الـ CheckBox الذي قام باستدعائها.

مكان الباراميتر value نضع إحدى ثوابت الكلاس ContentDisplay:
  • الثابت LEFT يجعل الصورة تظهر يسار النص كما يظهر بشكل إفتراضي.
  • الثابت RIGHT يجعل الصورة تظهر يمين النص.
  • الثابت TOP يجعل الصورة تظهر تحت النص.
  • الثابت BOTTOM يجعل الصورة تظهر فوق النص.
  • الثابت CENTER يجعل النص يظهر على الصورة.
  • الثابت GRAPHIC_ONLY يجعل الصورة فقط تظهر.
  • الثابت TEXT_ONLY يجعل النص فقط يظهر.
public final void setDisable(boolean value) تستخدم لجعل نص كائن الـ CheckBox الذي قام باستدعائها يبدو غير مفعّل, أي يصبح لونه باهتاً و غير قابل للنقر عليه.
مكان الباراميتر value نضع القيمة true لجعله غير مفعّل.
public final void setOnAction(EventHandler<ActionEvent> e) تستخدم لتنفيذ أوامر معينة عند النقر على كائن الـ CheckBox الذي قام بإستدعائها.
public final boolean isSelected() تستخدم لمعرفة إذا تم إختيار كائن الـ CheckBox الذي قام بإستدعائها, أي كان ظاهراً أنه منقور عليه أم لا.
ترجع true إذا كان يبدو أنه منقور عليه و ترجع false إذا كان لا يبدو كذلك.
public final void setSelected(boolean value) تستخدم لإختيار أو إلغاء إختيار الكائن الـ CheckBox الذي قام بإستدعائها.
مكان الباراميتر value نضع true إذا أردنا جعله مختاراً, و نضع false إذا لم نرد جعله كذلك.
public final void setStyle(String value) تستخدم لتعديل تصميم كائن الـ CheckBox الذي قام بإستدعائها.
مكان الباراميتر value يمكنك تمرير إسم و قيمة أي خاصية تريد تعديلها في كائن الـ CheckBox بأسلوب لغة CSS لإظهاره بالشكل الذي تريده.

أمثلة شاملة


المثال الأول

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

طريقة إضافة CheckBox في javafx

شاهد المثال »



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

المثال التالي يعلمك طريقة تغيير نوع و حجم و لون خط الـ CheckBox.

طريقة تغيير حجم و لون خط الكائن CheckBox في javafx

شاهد المثال »



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

المثال التالي يعلمك طريقة معرفة الـ CheckBox الذي تم اختياره عليه عند النقر على Button.

طريقة معرفة الـ CheckBox الذي تم اختياره عند النقر على زر في javafx

شاهد المثال »



المثال الرابع

المثال التالي يعلمك طريقة تنفيذ أوامر عند النقر على CheckBox.

طريقة تنفيذ أوامر عند النقر على الـ CheckBox في javafx

شاهد المثال »

الدورات

أدوات مساعدة

الأقسام

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