الكلاس JColorChooser – الكلاس JColorChooser
الكلاس JColorChooser – الكلاس JColorChooser
الكلاس JColorChooser – الكلاس JColorChooser
الكلاس JColorChooser – الكلاس JColorChooser
المناهج السعوديةالكلاس JColorChooser – الكلاس JColorChooser
مقدمة
الكلاس JColorChooser يستخدم للحصول على Panel جاهزة و مخصصة لإختيار الألوان.
في العادة يتم إظهار Panel الألوان في JDialog عند النقر على زر مخصص لإختيار الألوان.
الـ Panel الذي يحتوي على Panel الألوان يسمى (Color Chooser Dialog).
بناؤه
- publicclass JColorChooser
- extends JComponent
- implements Accessible
كونستركتورات الكلاس JColorChooser
الجدول التالي يحتوي أهم الكونستركتورات الموجودة في الكلاس JColorChooser.
| الكونستركتور مع تعريفه | |
|---|---|
| 1 | publicJColorChooser()ينشئ كائن من الكلاس JColorChooser يمثل Panel مخصصة لإختيار الألوان. هنا يكون اللون الأبيض مختار بشكل إفتراضي. |
| 2 | publicJColorChooser(Color initialColor)ينشئ كائن من الكلاس JColorChooser يمثل Panel مخصصة لإختيار الألوان مع تحديد اللون الذي يكون مختاراً بشكل إفتراض. مكان الباراميتر initialColor نضع كائن من الكلاس Color يمثل اللون الذي سيكون مختاراً بشكل إفتراضي. |
دوال الكلاس JColorChooser
الجدول التالي يحتوي على أهم الدوال الموجودة في الكلاس JColorChooser.
| الدالة مع تعريفها | |
|---|---|
| 1 | public Color getColor()ترجع اللون المختار في كائن الـ JColorChooser الذي باستدعائها ككائن من الكلاس Color. |
| 2 | publicvoidsetColor(Color color)تستخدم لتحديد اللون الحالي في كائن الـ JColorChooser الذي باستدعائها. مكان البارميتر color نضع كائن من الكلاس Color يمثل اللون الذي سيتم إختياره. |
| 3 | publicvoidsetColor(int red, int green, int blue)تستخدم لتحديد اللون الحالي في كائن الـ JColorChooser الذي باستدعائها.
ترمي الإستثناء IllegalArgumentException في حال تم تمرير قيمة أصغر من 0 أو أكبر من 255 مكان أي باراميتر موجود فيها. |
| 4 | publicstatic Color showDialog(Component component, String title, Color initialColor)تظهر Dialog يحتوي Panel جاهزة و مخصصة لإختيار الألوان, بالإضافة إلى ثلاث أزرار Ok, Cancel و Reset. ترجع درجة اللون المختار مكان إستدعاءها إذا قام المستخدم بالنقر على الزر Ok. و ترجع القيمة null في حال نقر على زر الخروج أو على الزر Cancel.
ملاحظة: في حال قام المستخدم بالنقر على Ok أو Cancel فإنه يتم إخفاء الـ Dialog و مسحه من الذاكرة. |
| 5 | publicstatic JDialog createDialog(. Component component,. String title,. boolean modal,. JColorChooser chooserPane,. ActionListener okListener,. ActionListener cancelListener)ترجع Dialog جديد يحتوي Panel جاهزة و مخصصة لإختيار الألوان, بالإضافة إلى ثلاث أزرار Ok, Cancel و Reset.
ملاحظة: في حال قام المستخدم بالنقر على Ok أو Cancel فإنه يتم إخفاء الـ Dialog لكن لا يتم مسحه من الذاكرة. |
أمثلة شاملة
المثال الأول
المثال التالي يعلمك طريقة إظهار Color Chooser Dialog و معرفة اللون الذي قام المستخدم بإختياره منه.
المثال الثاني
المثال التالي يعلمك طريقة إظهار Color Chooser Dialog عند النقر على زر معين لإختيار الألوان.
اللون الذي يقوم المستخدم بإختياره سيتم وضعه كخلفية للـ Frame عند النقر على الزر Ok.
في كل مرة يقوم فيها المستخدم بإظهار الـ Color Chooser Dialog سيوضع لون خلفية الـ Frame كاللون الإفتراضي المختار فيه.
المثال الثالث
المثال التالي يعلمك طريقة إنشاء الـ Color Chooser Dialog مرة واحدة و إظهاره فقط عند النقر على زر معين لإختيار الألوان.
بالإضافة إلى تغيير محتوى الـ Preview إلى فقط نص.
اللون الذي يقوم المستخدم بإختياره سيتم وضعه كخلفية للـ Frame عند النقر على الزر Ok.
في كل مرة يقوم فيها المستخدم بإظهار الـ Color Chooser Dialog سيوضع لون خلفية الـ Frame كاللون الإفتراضي المختار فيه.
المصدر: الكلاس JColorChooser – المناهج السعودية
