JavaFX الكلاس ColorPicker

مقدمة

الكلاس ColorPicker يستخدم للحصول على ComboBox خاص لإختيار الألوان ( Color Chooser ), حيث تجد أنه بمجرد النقر على الزر سيظهر أمامك عدة خيارات تتيح لك إختيار أي لون تريد بكل سهولة.


بناء الكلاس ColorPicker

public class ColorPicker
extends ComboBoxBase<Color>
	


الآن, إذا قمت بإنشاء كائن من الكلاس ColorPicker و أضفته في النافذة فإنه سيظهر كـ ComboBox فيه مربع صغير لونه أبيض و بجانبه كلمة White و التي يعني أبيض باللغة الإنجليزية.

javafx ColorPicker

بمجرد أن تنقر على الـ ColorPicker سيظهر تحته قائمة خاصة لإختيار الألوان ( Palette ).

javafx ColorPicker

في حال لم تعجبك الألوان التي في الـ Palette يمكنك النقر على الزر Custom Color... لإظهار نافذة مخصصة لإختيار درجة اللون ( Custom Color Dialog Window ).

بعد إختيار اللون الذي تريده من هذه النافذة, عندك ثلاث خيارات:

  • النقر على الزر Use لإختيار اللون.
  • النقر على الزر Save في حال أردت حفظ اللون مع الألوان الموجودة في الـ Palette.
  • النقر على الزر Cancel لإغلاق النافذة.

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

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

الكونستركتور مع تعريفه
public ColorPicker() ينشئ كائن من الكلاس ColorPicker يمثل ComboBox مخصص لإختيار الألوان.
و هنا يكون اللون الأبيض مختار بشكل إفتراضي.
public ColorPicker(Color color) ينشئ كائن من الكلاس ColorPicker يمثل ComboBox مخصص لإختيار الألوان, مع تحديد اللون الذي سيظهر مختاراً فيه بشكل إفتراضي.
مكان الباراميتر color نضع كائن من الكلاس Color يمثل اللون الذي سيكون مختاراً بشكل إفتراضي.

دوال الكلاس ColorPicker

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

الدالة مع تعريفها
public final void setTranslateX(double value) تستخدم لتحديد مكان كائن الـ ComboBox الذي قام باستدعائها أفقياً.
مكان الباراميتر value نضع رقم يمثل كم Pixel سيتم إزاحته من اليسار إلى اليمين.
public final void setTranslateY(double value) تستخدم لتحديد مكان كائن الـ ComboBox الذي قام باستدعائها عامودياً.
مكان الباراميتر value نضع رقم يمثل كم Pixel سيتم إزاحته من الأعلى إلى الأسفل.
public void setPrefSize(double prefWidth, double prefHeight) تستخدم لتحديد حجم كائن الـ ComboBox الذي قام باستدعائها.

  • مكان الباراميتر prefWidth نضع رقم يمثل عرض الـ ComboBox بالـ Pixel.
  • مكان الباراميتر prefHeight نضع رقم يمثل طول الـ ComboBox بالـ Pixel.
public final void setDisable(boolean value) تستخدم لجعل كائن الـ ComboBox الذي قام باستدعائها يبدو غير مفعّل, أي يصبح لونه باهتاً و غير قابل للنقر عليه.
مكان الباراميتر value نضع القيمة true لجعله غير مفعّل.
public final Color getValue() ترجع كائن من الكلاس Color يحتوي على قيمة اللون المختار في كائن الـ ColorPicker الذي قام باستدعائها.
public void setValue(Color color) تستخدم لتحديد اللون الحالي في كائن الـ ColorPicker الذي باستدعائها.
مكان البارميتر color نضع كائن من الكلاس Color يمثل اللون الذي سيتم إختياره.
public final void setStyle(String value) تستخدم لتعديل تصميم كائن الـ ColorPicker الذي قام بإستدعائها.
مكان الباراميتر value يمكنك تمرير إسم و قيمة أي خاصية تريد تعديلها في كائن الـ ColorPicker بأسلوب لغة CSS لإظهاره بالشكل الذي تريده.

أمثلة شاملة


المثال الأول

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

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

شاهد المثال »



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

المثال التالي يعلمك طريقة تغيير تصميم الـ ColorPicker.

طريقة تغيير تصميم ال ColorPicker في javafx

شاهد المثال »



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

المثال التالي يعلمك طريقة الحصول على قيمة اللون الذي قام المستخدم باختياره في الـ ColorPicker و وضعها كخلفية للنافذة.

طريقة الحصول على اللون الذي إختاره المستخدم من ال ColorPicker و وضعه كخلفية للنافذة في javafx

شاهد المثال »

الدورات

أدوات مساعدة

أقسام الموقع

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