ما هو الكلاس TilePane وما هي أهم الكلاسات التي تستخدم معه

اقرأ في هذا المقال


ما هو الكلاس TilePane في Java FX:

يُعد الكلاس (TilePane) من الكلاسات المهمة التي تستخدم مع (JavaFx)، حيث يستخدم لإنشاء (container) تقوم بترتيب العناصر التي يتم إضافتها فيها بشكل أفقي أو عمودي كما هو الحال في الكلاس (FlowPane)، وبشكل افتراضي فإن العناصر التي يتم إضافتها في كائن الـ (TilePane) يتم عرضها بشكل أفقي في المنطقة العليا من جهة اليسار.

والفرق الرئيسي بين الكلاس (TilePane) والكلاس (FlowPane) هو أن الكلاس (TilePane) يضع هامش حول جميع العناصر الموجودة فيه بناءاً على مساحة أكبر عنصر تم وضعه فيه، ويتم تعريفه على النحو التالي:

publicclass TilePaneextends Pane

أهم الكونستركتورات الخاصة بالكلاس TilePane في Java FX:

الجدول التالي يحتوي على أهم الكونستركتورات الخاصة بالكلاس (TilePane):

Constructorالاستخدام
()publicTilePane

يقوم هذا الكونستركتور بإنشاء كائن من نوع (TilePane) والذي يمثل (container) فارغة تقوم بترتيب العناصر التي يتم إضافتها بشكل أفقي من الأعلى و من جهة اليسار.

publicTilePane(Node… children)

يقوم هذا الكونستركتور بإنشاء كائن من نوع (TilePane) والذي يمثل (container) تقوم بترتيب العناصر التي يتم إضافتها بشكل أفقي من الأعلى و من جهة اليسار مع تحديد العناصر التي نريد وضعها فيها، حيث مكان (children) يتم وضع العناصر التي يريد المستخدم وضعها فيها مع وضع فاصلة بين كل عنصرين.

publicTilePane(double hgap, double vgap)

يقوم هذا الكونستركتور بإنشاء كائن من نوع (TilePane) والذي يمثل حاوية فارغة تقوم بترتيب العناصر التي يتم إضافتها فيها بشكل أفقي من الأعلى و من جهة اليسار مع تحديد حجم المسافة الفارغة بين العناصر التي نضيفها فيها حيث:

  • مكان (hgap) يتم وضع رقم يمثل حجم المسافة الفارغة بشكل أفقي بالـ (Pixel) بين كل عنصرين نضيفهما فيها.
  • مكان (vgap)يتم وضع رقم يمثل حجم المسافة الفارغة بشكل عمودي بالـ (Pixel) بين كل عنصرين نضيفهما فيه.
publicTilePane(double hgap, double vgap, Node… children)يقوم هذا الكونستركتور بإنشاء كائن من نوع (TilePane) والذي يمثل (container) تقوم بترتيب العناصر التي يتم إضافتها فيها بشكل أفقي مع تحديد العناصر التي نريد وضعها فيها وحجم المسافة الفارغة بينهم حيث:
  • مكان (hgap) يتم وضع رقم يمثل حجم المسافة الفارغة بشكل أفقي بالـ (Pixel) بين كل عنصرين.
  • مكان (vgap) يتم وضع رقم يمثل حجم المسافة الفارغة بشكل عمودي بالـ (Pixel) بين كل عنصرين.
  • مكان (children) يتم وضع العناصر التي نريد وضعها فيها مع وضع فاصلة بين كل عنصرين.
publicTilePane(Orientation orientation)

يقوم هذا الكلاس بإنشاء كائن من نوع ( TilePane) والذي يمثل (container) تقوم بترتيب العناصر التي يتم أضافتها فيها مع تحديد ما إذا كانت ستظهر بشكل أفقي أو عمودي، حيث مكان (orientation) يتم وضع (Orientation.VERTICAL) في حال أراد المستخدم إظهار محتوى الـ (TilePane) بشكل عمودي، ويتم وضع (Orientation.HORIZONTAL) في حال أراد المستخدم إظهار محتوى الـ (TilePane) بشكل أفقي.

publicTilePane(Orientation orientation, Node… children)
يقوم هذا الكونستركتور بإنشاء كائن من نوع (TilePane) والذي يمثل (container) تقوم بترتيب العناصر التي يتم إضافتها مع تحديد ما إذا كانت ستظهر بشكل أفقي أو عمودي و تحديد الأشياء التي نريد وضعها فيها حيث:
مكان(orientation) يتم وضع (Orientation.VERTICAL) في حال أراد المستخدم إظهار محتوى الـ (TilePane) بشكل عمودي، أو يتم وضع (Orientation.HORIZONTAL) في حال أراد المستخدم إظهار محتوى الـ (TilePane) بشكل أفقي، ومكان (children) يتم وضع العناصر التي يريد وضعها فيها مع وضع فاصلة بين كل عنصرين. 

أهم الدوال الخاصة بالكلاس TilePane في Java FX:

الجدول التالي يحتوي على أهم الدوال الخاصة بالكلاس (TilePane):

الدالةالاستخدام
publicfinalvoidsetAlignment(Pos value)

تستخدم هذه الدالة لتحديد مكان ظهور العناصر التي سيتم وضعها في الكائن الخاص ب (TilePane) الذي قام باستدعائها.

publicfinalvoidsetOrientation(Orientation orientation)تستخدم هذه الدالة لتحديد ما إذا كان محتوى الكائن الخاص ب (TilePane) الذي قام باستدعائها سيظهر بشكل أفقي أو عمودي، حيث مكان (orientation ) يتم وضع إحدى الثوابت التالية:
  • (Orientation.VERTICAL): تُستخدم لجعل محتوى الـ (TilePane) يظهر بشكل عمودي.
  • (Orientation.HORIZONTAL): تستخدم لجعل محتوى الـ (TilePane) يظهر بشكل أفقي.
publicfinalvoidsetPadding(Insets value)

تستخدم هذه الدالة لإضافة فراغ حول الكائن الخاص ب (TilePane) الذي قام باستدعائها، حيث مكان (value) يتم وضع كائن من نوع (Insets) والذي يتم من خلاله تحديد حجم الفراغ الذي سيتم إضافته من الجهات الأربعة.

publicfinalvoidsetHgap(double value)

تستخدم هذه الدالة لتحديد حجم الفراغ الذي يظهر بشكل أفقي بين كل عنصرين يتم إضافتهما في الكائن الخاص ب (TilePane) الذي قام باستدعائها، حيث مكان (value) يتم وضع رقم يمثل حجم الفراغ بالـ(Pixel).

المصدر: Class TilePaneJavaFX TilePaneJavaFX - Layout TilePaneJavaFX TilePane Layout Tutorial


شارك المقالة: