JavaFX الكلاس ToggleButton

مقدمة

الكلاس ToggleButton يستخدم لإضافة زر فيه حالتين " تشغيل - إيقاف " (Toggle Button) في واجهة المستخدم.
فكرة هذا الزر بشكل عام, هي أنه عند النقر عليه يظل ظاهراً أنه قد تم النقر عليه. و عند النقر عليه من جديد أنه لم يعد مختاراً.

محتوى هذا الزر يمكن أن يكون: نص, أيقونة, نص و أيقونة بجانبه.

يمكن وضع عدة ToggleButton و جعل المستخدم قادر على النقر عليهم كلهم إن أراد.
و يمكن أيضاً وضع عدة ToggleButton ضمن مجموعة واحدة فيصبح بإمكان المستخدم النقر على زر واحد في كل مرة.


بناء الكلاس ToggleButton

public class ToggleButton
extends ButtonBase
implements Toggle
	

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

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

الكونستركتور مع تعريفه
public ToggleButton() ينشئ كائن من الكلاس ToggleButton يمثل زر فارغ.
public ToggleButton(String text) ينشئ كائن من الكلاس ToggleButton يمثل زر عليه نص.
مكان الباراميتر text نمرر النص الذي نريد وضعه على الزر.
public ToggleButton(String text, Node graphic) ينشئ كائن من الكلاس ToggleButton يمثل زر عليه نص و أيقونة معاً.

  • مكان الباراميتر text نمرر النص الذي نريد وضعه على الزر.
  • مكان الباراميتر graphic نمرر كائن من الكلاس Node يمثل الأيقونة التي سيتم وضعها على الزر.

دوال الكلاس ToggleButton

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

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

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

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

أمثلة شاملة


المثال الأول

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

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

شاهد المثال »



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

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

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

شاهد المثال »



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

المثال التالي يعلمك طريقة تغيير نص الـ ToggleButton عند النقر عليه.

طريقة تغيير نص الـ ToggleButton عند النقر عليه في javafx

شاهد المثال »



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

المثال التالي يعلمك طريقة وضع أيقونة للـ ToggleButton و طريقة جعل ToggleButton واحد قابل للإختيار في وقت واحد.

طريقة وضع أيقونة للـ ToggleButton و طريقة جعل ToggleButton واحد قابل للإختيار في وقت واحد في javafx

شاهد المثال »

الدورات

أدوات مساعدة

الأقسام

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