مقدمة
الكلاس ProgressIndicator
يستخدم لإضافة Progress Indicator في واجهة المستخدم.
الـ Progress Indicator يستخدم في العادة للأسباب التالية:
- لجعل المستخدم يدرك أن عليه الإنتظار قليلاً حتى يتم تنفيذ شيء معين.
- لجعل المستخدم يدرك كم سيستغرق إجراء عملية معينة. مثل عند نسخ ملف أو تحميل ملف من النت.
- لجعل المستخدم يدرك كم بقي معه وقت حتى ينهي شيء معين. مثل في حال إنشاء برنامج إختبار.
بناء الكلاس ProgressIndicator
public class ProgressIndicator extends Control
ملاحظة: الكلاس ProgressIndicator
هو الكلاس الأب للكلاس ProgressBar
الذي شرحناه في الدرس السابق.
لهذا السبب ستجد أن التعامل مع الكلاس ProgressIndicator
يشبه تماماً التعامل مع الكلاس ProgressBar
.
مصطلحات تقنية
الـ ProgressIndicator
الذي له قيمة محددة كما في الصورة التالية يسمى Determinate Progress Indicator.
الـ ProgressIndicator
الذي ليس له قيمة محددة كما في الصورة التالية يسمى Indeterminate Progress Indicator.
طريقة التعامل معه
للحصول على Progress Bar, يجب إنشاء كائن من الكلاس ProgressIndicator
.
عند تحديد قيمة الـ ProgressIndicator
يجب وضع رقم بين 0 و 1 و هذا سيمثل بدوره النسبة المئوية لإكتمال الـ ProgressIndicator
. و إليك بعض الأمثلة:
- إذا وضعت 0 فهذا يمثل 0%.
- إذا وضعت 0.40 فهذا يمثل 40%.
- إذا وضعت 1 فهذا يمثل 100%.
لتغيير لون كائن الـ ProgressIndicator
نستخدم الدالة setStyle()
و نغيير قيمة خاصية إسمها -fx-accent
.
في حال قمت بإنشاء كائن من الـ ProgressIndicator
و لم تقم بتحديد قيمته الأولية أو قمت بوضع قيمة أصغر من 0 كقيمة له أولية مثل 1- فإنه سيظهر كـ Indeterminate Progress Indicator.