JavaFX الكلاس Label

مقدمة

الكلاس Label يستخدم لإضافة عنوان (Label) في واجهة المستخدم.
محتوى هذا العنوان يمكن أن يكون: نص, أيقونة, نص و أيقونة بجانبه.


بناء الكلاس Label

public class Label
extends Labeled
	

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

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

الكونستركتور مع تعريفه
public Label() ينشئ كائن من الكلاس Label يمثل عنوان فارغ.
public Label(String text) ينشئ كائن من الكلاس Label يمثل عنوان.
مكان الباراميتر text نمرر النص الذي نريد وضعه كعنوان.
public Label(String text, Node graphic) ينشئ كائن من الكلاس Label يمثل نص و أيقونة معاً كعنوان.

  • مكان الباراميتر text نمرر النص الذي نريد وضعه في العنوان.
  • مكان الباراميتر graphic نمرر كائن من الكلاس Node يمثل الأيقونة التي سيتم وضعها في العنوان.

دوال الكلاس Label

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

الدالة مع تعريفها
public String getText() ترجع نص كائن الـ Label الذي قام بإستدعائها كنص.
public void setText(String text) تستخدم لتبديل نص كائن الـ Label الذي قام بإستدعائها.
مكان الباراميتر text نضع النص الجديد.
public final void setTextFill(Paint value) تستخدم لتحديد لون نص كائن الـ Label الذي قام بإستدعائها.
مكان الباراميتر value نضع كائن من إحدى الكلاسات التي ترث من الكلاس Paint و التي يمكن إستخدامها لتحديد درجة اللون.
public final void setBackground(Background value) تستخدم لوضع لون أو صورة كخلفية لكائن الـ Label الذي قام بإستدعائها.
مكان الباراميتر value نضع كائن من الكلاس Background يشير إلى درجة اللون أو الصورة التي سيتم وضعها كخلفية.
public final void setFont(Font newFont) تستخدم لتحديد حجم و نوع خط كائن الـ Label الذي قام بإستدعائها.
مكان الباراميتر newFont نضع كائن من الكلاس Font يمثل خصائص الخط الجديد.
public final void setUnderline(boolean value) تستخدم لوضع خط تحت نص كائن الـ Label الذي قام بإستدعائها.
مكان الباراميتر value نضع القيمة true لإظهار خط تحت النص.
public final void setRotate(double degree) تستخدم لإدارة نص كائن الـ Label الذي قام بإستدعائها.
مكان الباراميتر degree نضع رقم يمثل درجة الدوران.
public final void setWrapText(boolean value) تستخدم لجعل نص كائن الـ Label الذي قام بإستدعائها ينزل على سطر جديد في حال كان لا يسع في سطر واحد.
مكان الباراميتر value نضع القيمة true لجعل الأحرف تظهر على سطر جديد عند الحاجة.
public final void setLineSpacing(double value) تستخدم لتحديد المسافة بين كل سطرين في نص كائن الـ Label الذي قام باستدعائها.
مكان الباراميتر value نضع رقم يمثل المسافة بين كل سطرين بالـ Pixel.
public final void setPadding(Insets value) تستخدم لإضافة هامش ( مسافة فارغة ) حول نص كائن الـ Label الذي قام باستدعائها.
مكان الباراميتر value نضع كائن من الكلاس Insets يمثل حجم الهامش حول النص من كل الجهات.
public final void setScaleX(double value) تستخدم لتمطيط الـ Label الذي قام باستدعائها بشكل أفقي.
مكان الباراميتر value نضع رقم يمثل كم مرة سيتم مضاعفة حجمه أفقياً.
public final void setScaleY(double value) تستخدم لتمطيط الـ Label الذي قام باستدعائها بشكل عامودي.
مكان الباراميتر value نضع رقم يمثل كم مرة سيتم مضاعفة حجمه عامودياً.
public final void setTranslateX(double value) تستخدم لتحديد مكان الـ Label الذي قام باستدعائها أفقياً.
مكان الباراميتر value نضع رقم يمثل كم Pixel سيتم إزاحته من اليسار إلى اليمين.
public final void setTranslateY(double value) تستخدم لتحديد مكان الـ Label الذي قام باستدعائها عامودياً.
مكان الباراميتر value نضع رقم يمثل كم Pixel سيتم إزاحته من الأعلى إلى الأسفل.
public void setPrefSize(double prefWidth, double prefHeight) تستخدم لتحديد حجم الـ Label الذي قام باستدعائها.

  • مكان الباراميتر prefWidth نضع رقم يمثل عرض الـ Label بالـ Pixel.
  • مكان الباراميتر prefHeight نضع رقم يمثل طول الـ Label بالـ Pixel.
public final void setContentDisplay(ContentDisplay value) تستخدم لتحديد مكان ظهور الأيقونة التي تم إضافتها لكائن الـ Label الذي قام باستدعائها.

مكان الباراميتر value نضع إحدى ثوابت الكلاس ContentDisplay:
  • الثابت LEFT يجعل الصورة تظهر يسار النص كما يظهر بشكل إفتراضي.
  • الثابت RIGHT يجعل الصورة تظهر يمين النص.
  • الثابت TOP يجعل الصورة تظهر تحت النص.
  • الثابت BOTTOM يجعل الصورة تظهر فوق النص.
  • الثابت CENTER يجعل النص يظهر على الصورة.
  • الثابت GRAPHIC_ONLY يجعل الصورة فقط تظهر.
  • الثابت TEXT_ONLY يجعل النص فقط يظهر.
public final void setDisable(boolean value) تستخدم لجعل نص كائن الـ Label الذي قام باستدعائها يبدو غير مفعّل, أي يصبح لونه باهتاً و غير قابل للنقر عليه.
مكان الباراميتر value نضع القيمة true لجعله غير مفعّل.
public final void setStyle(String value) تستخدم لتعديل تصميم كائن الـ Label الذي قام بإستدعائها.
مكان الباراميتر value يمكنك تمرير إسم و قيمة أي خاصية تريد تعديلها في كائن الـ Label بأسلوب لغة CSS لإظهاره بالشكل الذي تريده.

أمثلة شاملة


المثال الأول

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

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

شاهد المثال »



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

المثال التالي يعلمك طريقة تغيير نوع و حجم و لون خط الـLabel.

طريقة تغيير حجم و لون خط الكائن Label في javafx

شاهد المثال »



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

المثال التالي يعلمك طريقة تغيير لون خلفية الـ Label و إضافة هامش حوله.

طريقة تغيير لون الكائن Label و إضاقة هامش حوله في javafx

شاهد المثال »



المثال الرابع

المثال التالي يعلمك طريقة إضافة أيقونة للـ Label مع تحديد مكان ظهورها.

طريقة إضافة أيقونة للـ Label مع تحديد مكان ظهورها في javafx

شاهد المثال »



المثال الخامس

المثال التالي يعلمك طريقة عرض نص الـ Label بشكل عامودي.

طريقة عرض نص الـ Label عامودياً في javafx

شاهد المثال »



المثال السادس

المثال التالي يعلمك طريقة عرض نص الـ Label بشكل مائل.

طريقة عرض نص الـ Label بشكل مائل في javafx

شاهد المثال »



المثال السابع

المثال التالي يعلمك طريقة تنفيذ أوامر عند تمرير الفأرة فوق الـLabel.

طريقة تنفيذ أوامر عند تمرير الفأرة فوق الـ Label في javafx

شاهد المثال »

الدورات

أدوات مساعدة

أقسام الموقع

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