JavaFX الكلاس TitledPane و الكلاس Accordion

مقدمة

في هذا الدرس سنتعلم إستخدام الكلاس TitledPane و الكلاس Accordion مع بعض لإنشاء مجموعة من الحاويات المترابطة و القابلة للطي بدون كتابة أي كود معقد.


الكلاس TitledPane يستخدم لإنشاء حاوية قابلة للطي مما يجعل المستخدم قادر على إظهار محتواها أو إخفائه. هذه الحاوية تتألف من قسمين:

  • قسم يوضع فيه العنوان الذي يظل ظاهراً و الذي عند النقر عليه يتم إظهار أو إخفاء المحتوى.
  • قسم يوضع فيه المحتوى الذي لا يظهر إلا عند النقر على العنوان.

الكلاس Accordion يستخدم لوضع عدة TitledPane ضمن مجموعة واحدة.

في الـ Accordion يمكن فتح TitledPane واحد في كل مرة. أي إذا كان يوجد TitledPane مفتوح ثم قام المستخدم بالنقر على TitledPane آخر, فإنه سيتم إغلاق الـ TitledPane الأول بشكل تلقائي.


إفتراضياً, إذا كان الـ TitledPane غير موضوع بداخل Accordion, فإن محتواه سيكون ظاهراً عند تشغيل البرنامج, مع الإشارة إلى أنك تستطيع جعله غير ظاهراً.
و بالنسبة للمؤثرات التي تظهر عند النقر الـ TitledPane فيمكنك إبطالها أو إبقائها على حسب ما تحتاج لكنك على الأغلب ستبقيها.


تنبيه

لا تقم أبداً بتحديد طول الـ Accordion أو الـ TitledPane لأن ذلك قد يؤثر سلباً على المؤثرات التي تظهر عند فتحه و إغلاقه.
مع الإشارة إلى أن تحديد عرض الـ Accordion أو الـ TitledPane لا يسبب أي مشكلة.

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

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

الكونستركتور مع تعريفه
public TitledPane() ينشئ كائن من الكلاس TitledPane يمثل حاوية فارغة قابلة للطي.
public TitledPane(String Title, Node content) ينشئ كائن من الكلاس TitledPane يمثل حاوية قابلة للطي مع تحديد عنوانها و محتواها.
مكان الباراميتر Title نمرر النص الذي سيتم وضعه كعنوان للحاوية.
مكان الباراميتر content نمرر أي شيء نريد وضعه كمحتوى للحاوية.

ملاحظة: في الأمثلة الموضوعة في نهاية الدرس إستخدمنا الكونستركتور الثاني لتقليل حجم الكود.

دوال الكلاس TitledPane

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

الدالة مع تعريفها
public final void setText(String value) تستخدم لتحديد عنوان كائن الـ TitledPane الذي قام باستدعائها.
مكان الباراميتر value نمرر النص الذي نريد وضعه كعنوان له.
public final void setContent(Node value) تستخدم لتحديد محتوى كائن الـ TitledPane الذي قام باستدعائها.
مكان الباراميتر Node نمرر أي شيء نريد وضعه كمحتوى له.
public final void setAnimated(boolean value) تستخدم لتحديد ما إذا كان كائن الـ TitledPane الذي قام باستدعائها سيظهر مؤثرات عندما يتم إظهار أو إخفاء محتواه أم لا.
مكان الباراميتر value نمرر القيمة true في حال أردنا جعله يظهر مؤثرات. إذا لم نرد ذلك نضع القيمة false.

ملاحظة: إفتراضياً, الـ TitledPane يظهر مؤثرات عند فتحه و إغلاقه.
public final void setCollapsible(boolean value) تستخدم لتحديد ما إذا كان يمكن إظهار محتوى كائن الـ TitledPane الذي قام باستدعائها أم لا.
مكان الباراميتر value نمرر القيمة true في حال أردنا جعل محتواه غير قابل للرؤية. إذا لم نرد ذلك نضع القيمة false.

ملاحظة: إفتراضياً, الـ TitledPane يمكن رؤية ما يحتويه.

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

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

الكونستركتور مع تعريفه
public Accordion() ينشئ كائن من الكلاس Accordion يمثل حاوية فارغة مخصصة لإحتواء مجموعة حاويات نوعها TitledPane.
public TitledPane(TitledPane... titledPanes) ينشئ كائن من الكلاس Accordion يمثل حاوية مخصصة لإحتواء مجموعة حاويات نوعها TitledPane.
مكان الباراميتر titledPanes يمكنك تمرير العدد الذي تريده من الحاويات.

دوال الكلاس Accordion

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

الدالة مع تعريفها
public final void setAlignment(Pos value) تستخدم لتحديد مكان ظهور كائن الـ Accordion الذي قام باستدعائها.
مكان الباراميتر value نمرر إحدى ثوابت الكلاس Pos:
  • TOP_LEFT: لإظهاره في الأعلى ناحية اليسار.
  • TOP_CENTER: لإظهاره في الأعلى و في الوسط.
  • TOP_RIGHT: لإظهاره في الأعلى ناحية اليمين.
  • CENTER_LEFT: لإظهاره في الوسط ناحية اليسار.
  • CENTER: لإظهاره في الوسط تماماً.
  • CENTER_RIGHT: لإظهاره في الوسط ناحية اليمين.
  • BOTTOM_LEFT: لإظهاره في الأسفل ناحية اليسار.
  • BOTTOM_CENTER: لإظهاره في الأسفل و في الوسط.
  • BOTTOM_RIGHT: لإظهاره في الأسفل ناحية اليمين.
public final void setPadding(Insets value) تستخدم لإضافة فراغ حول كائن الـ Accordion الذي قام باستدعائها.
مكان الباراميتر value نمرر كائن من الكلاس Insets نحدد فيه حجم الفراغ الذي سيتم إضافته من الجهات الأربعة ( فوقه, يمينه, تحته, يساره ).
public final void setStyle(String value) تستخدم لتعديل تصميم كائن الـ Accordion الذي قام بإستدعائها.
مكان الباراميتر value يمكنك تمرير إسم و قيمة أي خاصية تريد تعديلها في كائن الـ Accordion بأسلوب لغة CSS لإظهاره بالشكل الذي تريده.
public ObservableList<Node> getChildren() ترجع كائن نوعه ObservableList يمثل محتوى كائن الـ Accordion الذي قام بإستدعائها مما يجعلك قادراً على إضافة كائنات جديدة أو حذف كائنات موجودة فيه.

أمثلة شاملة


المثال الأول

المثال التالي يعلمك طريقة إنشاء كائن من الكلاس TitledPane و تحديد عنوانه و محتواه.

طريقة إنشاء TitledPane في JavaFX

شاهد المثال »



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

المثال التالي يعلمك طريقة وضع مجموعة كائنات من الكلاس TitledPane في كائن من الكلاس Accordion.

طريقة وضع مجموعة كائنات من الكلاس TitledPane في كائن من الكلاس Accordion في JavaFX

شاهد المثال »



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

المثال التالي يعلمك طريقة وضع أي شيء تريده كمحتوى في الـ TitledPane.

طريقة وضع أي شيء كمحتوى لل TitledPane في JavaFX

شاهد المثال »

الدورات

أدوات مساعدة

أقسام الموقع

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