JavaFXالكلاس `VBox`

مقدمة
كونستركتورات الكلاس VBox
دوال الكلاس VBox
أمثلة شاملة

مقدمة

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

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

حجم كائن الـ VBox يمكن تحديده, و يمكن تحديد ما إذا كانت الأشياء بداخله سيتغير حجمها مع تغيّر حجمه أم أن حجمها ثابت لا يتغير.

حجم الفراغ بين الأشياء التي نضيفها فيه يمكن تحديده من جميع الإتجاهات.

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

public class VBox
extends Pane

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

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

الكونستركتور مع تعريفه
1	`VBox()` ينشئ كائن من الكلاس `VBox` يمثل حاوية فارغة ترتب الأشياء التي نضيفها فيها بشكل عامودي.
2	`VBox(double spacing)` ينشئ كائن من الكلاس `VBox` يمثل حاوية فارغة ترتب الأشياء التي نضيفها فيها بشكل عامودي مع تحديد المسافة الفارغة بين الأشياء التي نضيفها فيها. مكان الباراميتر `spacing` نمرر رقم يمثل حجم المسافة الفارغة التي سيتم وضعها بين الأشياء التي نضيفها فيها.
3	`VBox(Node... children)` ينشئ كائن من الكلاس `VBox` يمثل حاوية ترتب الأشياء التي نضيفها فيها بشكل عامودي مع تحديد الأشياء التي نريد وضعها فيها. مكان الباراميتر `children` نمرر الأشياء التي نريد وضعها فيها مع وضع فاصلة بين كل شيئين.
4	`VBox(double spacing, Node... children)` ينشئ كائن من الكلاس `VBox` يمثل حاوية ترتب الأشياء التي نضيفها فيها بشكل عامودي مع تحديد الأشياء التي نريد وضعها فيها و المسافة الفارغة بينهم. مكان الباراميتر `spacing` نمرر رقم يمثل حجم المسافة الفارغة التي سيتم وضعها بين الأشياء التي نضيفها فيها. مكان الباراميتر `children` نمرر الأشياء التي نريد وضعها فيها مع وضع فاصلة بين كل شيئين.

دوال الكلاس `VBox`

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

الدالة مع تعريفها
1	`public void setSpacing(int value)` تستخدم لتحديد حجم الفراغ بين كل شيئين يتم إضافتهما في كائن الـ `VBox` الذي قام باستدعائها. مكان الباراميتر `value` نمرر رقم يمثل حجم الفراغ بالـ Pixel.
2	`public final void setAlignment(Pos value)` تستخدم لتحديد مكان ظهور الأشياء التي سيتم وضعها في كائن الـ `VBox` الذي قام باستدعائها. مكان الباراميتر `value` نمرر إحدى ثوابت الكلاس `Pos`: `TOP_LEFT`: يظهر المحتوى في الأعلى ناحية اليسار. `TOP_CENTER`: يظهر المحتوى في الأعلى و في الوسط. `TOP_RIGHT`: يظهر المحتوى في الأعلى ناحية اليمين. `CENTER_LEFT`: يظهر المحتوى في الوسط ناحية اليسار. `CENTER`: يظهر المحتوى في الوسط تماماً. `CENTER_RIGHT`: يظهر في الوسط ناحية اليمين. `BOTTOM_LEFT`: يظهر المحتوى في الأسفل ناحية اليسار. `BOTTOM_CENTER`: يظهر المحتوى في الأسفل و في الوسط. `BOTTOM_RIGHT`: يظهر المحتوى في الأسفل ناحية اليمين.
3	`public final void setFillWidth(boolean value)` تستخدم لتحديد ما إذا كانت الأشياء التي سنضيفها في كائن الـ `VBox` الذي قام باستدعائها ستتأثر بعرضه أم لا. مكان الباراميتر `value` نمرر القيمة `true` في حال أردنا جعل عرض الأشياء يتغير بشكل تلقائي نسبة لطول الـ `VBox`.
4	`public static void setMargin(Node child, Insets value)` تستخدم لإضافة فراغ حول أي شيء موضوع بداخل `VBox`. مكان الباراميتر `child` نمرر الشيء الذي نريد إضافة فراغ حوله. مكان الباراميتر `value` نمرر كائن من الكلاس `Insets` نحدد فيه حجم الفراغ الذي سيتم إضافته للشيء من الجهات الأربعة ( فوقه, يمينه, تحته, يساره ).
5	`public static void setVgrow(Node child, Priority value)` تستخدم لتحديد ما إذا كان طول الشيء الموضوع بداخل `VBox` سيتأثر بطوله أم أن طوله سيظل ثابت. مكان الباراميتر `child` نمرر الشيء الذي نريد تحديد ما إن كان طوله سيتأثر بطول الـ `VBox` أم لا. مكان الباراميتر `value` نمرر إحدى ثوابت الكلاس `Priority` التي تحدد ذلك: `ALWAYS`: لجعل طول الشيء يظهر على أكبر مساحة متوفرة في كائن الـ `VBox`. `NEVER`: لجعل طول الشيء ثابت لا يتأُثر أبدً بحجم كائن الـ `VBox`. `SOMETIMES`: لجعل طول الشيء يظهر على أكبر مساحة متوفرة في كائن الـ `VBox` في حال لم يكن هناك أي شيء آخر قد تم تعيينه ليظهر على أكبر مساحة متوفرة فيه.
6	`public final void setStyle(String value)` تستخدم لتعديل تصميم كائن الـ `VBox` الذي قام بإستدعائها. مكان الباراميتر `value` يمكنك تمرير إسم و قيمة أي خاصية تريد تعديلها في كائن الـ `VBox` بأسلوب لغة CSS لإظهاره بالشكل الذي تريده.
7	`public ObservableList<Node> getChildren()` ترجع كائن نوعه `ObservableList` يمثل محتوى كائن الـ `VBox` الذي قام بإستدعائها مما يجعلك قادراً على إضافة كائنات جديدة أو حذف كائنات موجودة فيه.