JavaFX الكلاس `GridPane`

مقدمة

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

إفتراضياً, حجم الـ GridPane يتحدد نسبة لحجم الأشياء الموضوعة فيه. أي كلما وضعت فيه أشياء كلما كبر حجمه. كما أنك تستطيع جعله يظهر على كل المساحة المتوفرة.

بالنسبة للأشياء التي تضيفها فيه فإنها تظهر في الأعلى ناحية اليسار. و أيضاً تستطيع تحديد مكان ظهورهم.
كما أنك تستطيع إضافة هامش ( فراغ ) بينهم حتى لا يظهروا بشكل متلاصق.

الآن, عند إنشاء كائن GridPane يجب تحديد من كم سطر و عامود يتألف. بعدها يصبح بإمكانك إضافة أي شيء تريد على سطر و عامود محدد فيه.
ملاحظة: أول سطر في كائن الـ GridPane يكون يملك رقم Index يساوي 0. و أول عامود في كل سطر يكون رقمه يكون يملك رقم Index يساوي 0.

بناء الكلاس `GridPane`

public class GridPane
extends Pane

كونستركتورات الكلاس `GridPane`

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

الكونستركتور مع تعريفه
`public GridPane()` ينشئ كائن من الكلاس `GridPane` يمثل حاوية فارغة ترتب الأشياء التي نضيفها فيها كجدول يتألف من أسطر و أعمدة متساوية الحجم.

دوال الكلاس `GridPane`

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

الدالة مع تعريفها
`public void add(Node child, int columnIndex, int rowIndex)` تستخدم لإضافة شيء في مكان محدد في كائن الـ `GridPane` الذي قام باستدعائها. مكان الباراميتر `child` نمرر الشيء الذي نريد إضافته. مكان الباراميتر `columnIndex` نمرر رقم يمثل Index العامود الذي نريد إضافة الشيء عليه. مكان الباراميتر `rowIndex` نمرر رقم يمثل Index السطر الذي نريد إضافة الشيء عليه.
`public static void setColumnSpan(Node child, Integer value)` تستخدم لجعل أي شيء موضوع بداخل `GridPane` يظهر على أكثر من عامود واحد. مكان الباراميتر `child` نمرر الشيء الذي نريد جعله يظهر على أكثر من عامود. مكان الباراميتر `value` نمرر رقم يمثل عدد الأعمدة التي نريده أن يظهر عليها.
`public static void setRowSpan(Node child, Integer value)` تستخدم لجعل أي شيء موضوع بداخل `GridPane` يظهر على أكثر من سطر واحد. مكان الباراميتر `child` نمرر الشيء الذي نريد جعله يظهر على أكثر من سطر. مكان الباراميتر `value` نمرر رقم يمثل عدد الأسطر التي نريده أن يظهر عليها.
`public final void setAlignment(Pos value)` تستخدم لتحديد مكان ظهور الأشياء التي سيتم وضعها في كائن الـ `GridPane` الذي قام باستدعائها. مكان الباراميتر `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)` تستخدم لإضافة فراغ حول كائن الـ `GridPane` الذي قام باستدعائها. مكان الباراميتر `value` نمرر كائن من الكلاس `Insets` نحدد فيه حجم الفراغ الذي سيتم إضافته من الجهات الأربعة ( فوقه, يمينه, تحته, يساره ).
`public final void setHgap(double value)` تستخدم لتحديد حجم الفراغ أفقياً ( أي من اليمين و من اليسار ) بين كل شيئين يتم إضافتهما في كائن الـ `GridPane` الذي قام باستدعائها. مكان الباراميتر `value` نمرر رقم يمثل حجم الفراغ بالـ Pixel.
`public final void setVgap(double value)` تستخدم لتحديد حجم الفراغ عامودياً ( أي من الأعلى و من الأسفل ) بين كل شيئين يتم إضافتهما في كائن الـ `GridPane` الذي قام باستدعائها. مكان الباراميتر `value` نمرر رقم يمثل حجم الفراغ بالـ Pixel.
`public static void setMargin(Node child, Insets value)` تستخدم لإضافة فراغ حول أي شيء موضوع بداخل `GridPane`. مكان الباراميتر `child` نمرر الشيء الذي نريد إضافة فراغ حوله. مكان الباراميتر `value` نمرر كائن من الكلاس `Insets` نحدد فيه حجم الفراغ الذي سيتم إضافته للشيء من الجهات الأربعة ( فوقه, يمينه, تحته, يساره ).
`public static void setHgrow(Node child, Priority value)` تستخدم لتحديد ما إذا كان عرض الشيء الموضوع بداخل `GridPane` سيتأثر بعرضه أم أن عرضه سيظل ثابت. مكان الباراميتر `child` نمرر الشيء الذي نريد تحديد ما إن كان عرضه سيتأثر بعرض الـ `GridPane` أم لا. مكان الباراميتر `value` نمرر إحدى ثوابت الكلاس `Priority` التي تحدد ذلك: `ALWAYS`: لجعل عرض الشيء يظهر على أكبر مساحة متوفرة في كائن الـ `GridPane`. `NEVER`: لجعل عرض الشيء ثابت لا يتأُثر أبدً بحجم كائن الـ `GridPane`. `SOMETIMES`: لجعل عرض الشيء يظهر على أكبر مساحة متوفرة في كائن الـ `GridPane` في حال لم يكن هناك أي شيء آخر قد تم تعيينه ليظهر على أكبر مساحة متوفرة فيه.
`public static void setVgrow(Node child, Priority value)` تستخدم لتحديد ما إذا كان طول الشيء الموضوع بداخل `GridPane` سيتأثر بطوله أم أن طوله سيظل ثابت. مكان الباراميتر `child` نمرر الشيء الذي نريد تحديد ما إن كان طوله سيتأثر بعرض الـ `GridPane` أم لا. مكان الباراميتر `value` نمرر إحدى ثوابت الكلاس `Priority` التي تحدد ذلك: `ALWAYS`: لجعل طول الشيء يظهر على أكبر مساحة متوفرة في كائن الـ `GridPane`. `NEVER`: لجعل طول الشيء ثابت لا يتأُثر أبدً بحجم كائن الـ `GridPane`. `SOMETIMES`: لجعل طول الشيء يظهر على أكبر مساحة متوفرة في كائن الـ `GridPane` في حال لم يكن هناك أي شيء آخر قد تم تعيينه ليظهر على أكبر مساحة متوفرة فيه.
`public final void setStyle(String value)` تستخدم لتعديل تصميم كائن الـ `GridPane` الذي قام بإستدعائها. مكان الباراميتر `value` يمكنك تمرير إسم و قيمة أي خاصية تريد تعديلها في كائن الـ `GridPane` بأسلوب لغة CSS لإظهاره بالشكل الذي تريده.