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 لإظهاره بالشكل الذي تريده.