Swingالكلاس GroupLayout
- مقدمة
- ثوابت الكلاس
GroupLayout - كونستركتورات الكلاس
GroupLayout - دوال الكلاس
GroupLayout - أمثلة شاملة
مقدمة
الكلاس GroupLayout يستخدم لترتيب الأشياء التي نضيفها ضمن مجموعات.
كل مجموعة يتم وضعها تكون في الأساس عبارة عن كائن من أحد الكلاسات التي ترث من الكلاس Group.
إنتبه: هنا سيتوجب عليك تحديد تسلسل جميع الأشياء التي أضفتها في المجموعة أفقياً و عمودياً.
و في حال لم تحدد تسلسل جميع الأشياء التي أضفتها أفقياً و عامودياً فإنه سيتم رمي الإستثناء IllegalArgumentException.
بناؤه
public class GroupLayout extends Object implements LayoutManager2
الكلاس GroupLayout يحتوي على ثلاث كلاسات بداخله تم تصميمهم لتحديد طريقة ترتيب عناصر كل مجموعة. الكلاسات هم:
- الكلاس
SequentialGroupيرث من الكلاسGroup, و يستخدم لترتيبب الأشياء التي نضعها في المجموعة وراء بعضها البعض. - الكلاس
ParallelGroupيرث من الكلاسGroup, و يستخدم لترتيبب الأشياء التي نضعها في المجموعة بشكل متوازي أفقياً أو عامودياً. - الكلاس الثابت
Alignmentيحتوي على الثوابت (BASELINE,CENTER,LEADING,TRAILING) و التي تستخدم لتحديد طريقة إصطفاف الأشياء التي يتم وضعها في المجموعة.
ثوابت الكلاس GroupLayout
الجدول التالي يحتوي على ثوابت الكلاس GroupLayout.
| الثابت | إستخدامه |
|---|---|
DEFAULT_SIZE |
يستخدم لتحديد الحجم الإفتراضي للأشياء أو الفراغ بينهم. |
PREFERRED_SIZE |
يستخدم لتحديد الحجم المفضل للأشياء أو الفراغ بينهم. |
كونستركتورات الكلاس GroupLayout
الجدول التالي يحتوي على كونستركتورات الكلاس GroupLayout.
| الكونستركتور مع تعريفه | |
|---|---|
| 1 | public GroupLayout(Container host)
يرتب الأشياء التي نضيفها في النافذة أو الحاوية كمجموعة واحدة.مكان الباراميتر host نضع النافذة أو الحاوية التي سيتم وضع المجموعة فيها.يرمي الإستثناء IllegalArgumentException في حال تم وضع null مكان الباراميتر host. |
دوال الكلاس GroupLayout
الجدول التالي يحتوي على أهم الدوال الموجودة في الكلاس GroupLayout.
| الدالة مع تعريفها | |
|---|---|
| 1 | public GroupLayout.SequentialGroup createSequentialGroup()
ترجع كائن من الكلاس SequentialGroup.أي تستخدم لإنشاء مجموعة ترتب المحتوى الذي يتم وضعه فيها وراء بعضه البعض. |
| 2 | public GroupLayout.ParallelGroup createParallelGroup(GroupLayout.Alignment alignment)
ترجع كائن من الكلاس ParallelGroup.أي تستخدم لإنشاء مجموعة ترتب المحتوى الذي يتم وضعه فيها بشكل متوازي مع تحديد طريقة إصطفاف الأشياء التي نضيفها فيها. مكان الباراميتر alignment نضع إحدى ثوابت الكلاس Alignment المخصصة لتحديد طريقة إصطفاف الأشياء التي يتم وضعها في المجموعة.ترمي الإستثناء IllegalArgumentException في حال تم وضع null مكان الباراميتر alignment. |
| 3 | public void setHorizontalGroup(GroupLayout.Group group)
تستخدم لتحديد تسلسل الأشياء المراد إضافتها في المجموعة أفقياً.مكان الباراميتر group نضع المجموعة التي سيتم تحديد تسلسل محتواها أفقياً.ترمي الإستثناء IllegalArgumentException في حال تم وضع null مكان الباراميتر group. |
| 4 | public void setVerticalGroup(GroupLayout.Group group)
تستخدم لتحديد تسلسل الأشياء المراد إضافتها في المجموعة عامودياً.مكان الباراميتر group نضع المجموعة التي سيتم تحديد تسلسل محتواها عامودياً.ترمي الإستثناء IllegalArgumentException في حال تم وضع null مكان الباراميتر group. |
| 5 | public void setAutoCreateGaps(boolean autoCreatePadding)
تستخدم لإضافة هامش بشكل تلقائي بين الأشياء التي تم إضافتها في المجموعة.مكان الباراميتر autoCreatePadding نضع القيمة true في حال أردنا إضافة هامش بشكل تلقائي بين الأشياء الموضوعة في المجموعة.و نضع false إذا لم نرد ذلك. |
| 6 | public void setAutoCreateContainerGaps(boolean autoCreateContainerPadding)
تستخدم لإضافة هامش بشكل تلقائي في محيط الأشياء التي تم إضافتها في المجموعة.مكان الباراميتر autoCreatePadding نضع القيمة true في حال أردنا إضافة هامش بشكل تلقائي بين الأشياء الموضوعة في المجموعة و حدودها.و نضع false إذا لم نرد ذلك. |
أمثلة شاملة
المثال الأول
المثال التالي يعلمك طريقة ترتيب محتوى الـ Frame بشكل متوازي أفقياً بواسطة الكلاس GroupLayout.
المثال الثاني
المثال التالي يعلمك طريقة ترتيب محتوى الـ Frame بشكل متوازي عامودياً بواسطة الكلاس GroupLayout.
المثال الثالث
المثال التالي يعلمك طريقة ترتيب محتوى الـ Frame بشكل متوازي أفقياً و عامودياً بواسطة الكلاس GroupLayout.
المثال الرابع
المثال التالي يعلمك طريقة إنشاء واجهة تسجيل دخول بواسطة الكلاس GroupLayout.
المثال الخامس
المثال التالي يعلمك طريقة تحديد حجم الأشياء التي تضيفها في الـ Frame و حجم الفراغات بينهم عند إستخدام الـكلاس GroupLayout.
المثال السادس
المثال التالي يعلمك طريقة جعل حجم الأشياء التي تضيفها في الـ Frame يتغير بشكل تلقائي عند تكبير أو تصغير النافذة عند إستخدام الكلاس GroupLayout.
أي ستتعلم كيف تجعل محتوى النافذة Resizable.
