JColorChooserالكلاس JColorChooser يستخدم للحصول على Panel جاهزة و مخصصة لإختيار الألوان.
في العادة يتم إظهار Panel الألوان في JDialog عند النقر على زر مخصص لإختيار الألوان.
الـ Panel الذي يحتوي على Panel الألوان يسمى (Color Chooser Dialog).
public class JColorChooser extends JComponent implements Accessible
JColorChooser
الجدول التالي يحتوي أهم الكونستركتورات الموجودة في الكلاس JColorChooser.
| الكونستركتور مع تعريفه | |
|---|---|
public JColorChooser()
ينشئ كائن من الكلاس JColorChooser يمثل Panel مخصصة لإختيار الألوان.هنا يكون اللون الأبيض مختار بشكل إفتراضي. |
|
public JColorChooser(Color initialColor)
ينشئ كائن من الكلاس JColorChooser يمثل Panel مخصصة لإختيار الألوان مع تحديد اللون الذي يكون مختاراً بشكل إفتراض.مكان الباراميتر initialColor نضع كائن من الكلاس Color يمثل اللون الذي سيكون مختاراً بشكل إفتراضي. |
|
JColorChooserالجدول التالي يحتوي على أهم الدوال الموجودة في الكلاس JColorChooser.
| الدالة مع تعريفها | |
|---|---|
public Color getColor()
ترجع اللون المختار في كائن الـ JColorChooser الذي قام باستدعائها ككائن من الكلاس Color. |
|
public void setColor(Color color)
تستخدم لتحديد اللون الحالي في كائن الـ JColorChooser الذي باستدعائها.مكان البارميتر color نضع كائن من الكلاس Color يمثل اللون الذي سيتم إختياره. |
|
public void setColor(int red, int green, int blue)
تستخدم لتحديد اللون الحالي في كائن الـ JColorChooser الذي قام باستدعائها.
ترمي الإستثناء IllegalArgumentException في حال تم تمرير قيمة أصغر من 0 أو أكبر من 255 مكان أي باراميتر موجود فيها. |
|
public static Color showDialog(Component component, String title, Color initialColor)
تظهر Dialog يحتوي Panel جاهزة و مخصصة لإختيار الألوان, بالإضافة إلى ثلاث أزرار Ok, Cancel و Reset.ترجع درجة اللون المختار مكان إستدعاءها إذا قام المستخدم بالنقر على الزر Ok. و ترجع القيمة null في حال نقر على زر الخروج أو على الزر Cancel.
ملاحظة: في حال قام المستخدم بالنقر على Ok أو Cancel فإنه يتم إخفاء الـ Dialog و مسحه من الذاكرة. و في حال قام بالنقر على Reset فإنه يتم إختيار اللون الذي كان مختاراً عندما تم إظهار الـ Dialog. |
|
public static JDialog createDialog( Component component, String title, boolean modal, JColorChooser chooserPane, ActionListener okListener, ActionListener cancelListener)
ترجع Dialog جديد يحتوي Panel جاهزة و مخصصة لإختيار الألوان, بالإضافة إلى ثلاث أزرار Ok, Cancel و Reset.
ملاحظة: في حال قام المستخدم بالنقر على Ok أو Cancel فإنه يتم إخفاء الـ Dialog لكن لا يتم مسحه من الذاكرة. و في حال قام بالنقر على Reset فإنه يتم إختيار اللون الذي كان مختاراً عندما تم إظهار الـ Dialog. |
|
المثال التالي يعلمك طريقة إظهار Color Chooser Dialog و معرفة اللون الذي قام المستخدم بإختياره منه.
المثال التالي يعلمك طريقة إظهار Color Chooser Dialog عند النقر على زر معين لإختيار الألوان.
اللون الذي يقوم المستخدم بإختياره سيتم وضعه كخلفية للـ Frame عند النقر على الزر Ok.
في كل مرة يقوم فيها المستخدم بإظهار الـ Color Chooser Dialog سيوضع لون خلفية الـ Frame كاللون الإفتراضي المختار فيه.
المثال التالي يعلمك طريقة إنشاء الـ Color Chooser Dialog مرة واحدة و إظهاره فقط عند النقر على زر معين لإختيار الألوان.
بالإضافة إلى تغيير محتوى الـ Preview إلى فقط نص.
اللون الذي يقوم المستخدم بإختياره سيتم وضعه كخلفية للـ Frame عند النقر على الزر Ok.
في كل مرة يقوم فيها المستخدم بإظهار الـ Color Chooser Dialog سيوضع لون خلفية الـ Frame كاللون الإفتراضي المختار فيه.
هرمش هو موقع تعليمي مجاني يهتم بعلوم الكمبيوتر و يقدم إليك المعرفة بشكل مبسّط و مفصّل, و هو المكان المناسب لأي شخص يطمح بأن يصبح مبرمجاً محترفاً و مبدعاً في العالم الرقمي.
محتوى الموقع يخضع لرخصة (CC BY-NC-ND 4.0) التي لا تسمح باستخدام الشروحات لأغراض تجارية، إجراء تعديل عليها، نشرها في موقع آخر، وضع الشروحات في تطبيق أو في كتاب إلا في حال أخذ موافقة صريحة من إدارة الموقع كما أن المحتوى مسجل بواسطة DMCA و بحال قيامك بمخالفة حقوق النشر سنضطر آسفين لاتخاذ الإجراءات اللازمة.
