الكلاس JSplitPane – الكلاس JSplitPane
الكلاس JSplitPane – الكلاس JSplitPane
الكلاس JSplitPane – الكلاس JSplitPane
الكلاس JSplitPane – الكلاس JSplitPane
المناهج السعوديةالكلاس JSplitPane – الكلاس JSplitPaneالكلاس JSplitPane – الكلاس JSplitPane
مقدمة
الكلاس JSplitPane يسمى Split Pane و يستخدم لتقسيم الـ Frame إلى عدة أقسام مع إمكانية سحب الأقسام يدوياً.
إذاً الـ Split Pane يضيف Splitter في الـ Frame فيقسمها إلى قسمين أساسيين.
يستطيع المستخدم تحريك هذا الـ Splitter لتغيير حجم الأقسام الموجودة في الـ Frame لعرض محتواها بالشكل الذي يريده.
يمكن تحديد الـ Split Pane لتقسيم الـ Frame عامودياً أو أفقياً.
و يمكن تقسيم القسم الواحد إلى عدة أقسام أيضاً و هذا يسمى Nested Split Panes.
لجعل القسم الذي تريد إضافته في الـ Split Pane يظهر Scroll Bar عند الحاجة ضعه بداخل JScrollPane.
لا تقلق ستفهم كل شيء لاحقاً من الأمثلة.
بناؤه
- publicclass JSplitPane
- extends JComponent
- implements Accessible
كونستركتورات الكلاس JSplitPane
الجدول التالي يحتوي على أهم الكونستركتورات الموجودة في الكلاس JSplitPane.
| الكونستركتور مع تعريفه | |
|---|---|
| 1 | publicJSplitPane()ينشئ كائن من الكلاس JSplitPane يضيف Splitter في الـ Frame, فيقسمها إلى قسمين بالعرض.ملاحظة: إذا لم تضع أي شيء في الأقسام, سيقوم بوضع زر واحد في كل قسم. |
| 2 | publicJSplitPane(int orientation)ينشئ كائن من الكلاس JSplitPane يضيف Splitter في الـ Frame, فيقسمها إلى قسمين بالعرض أو الطول. مكان الباراميتر orientation نضع إحدى الثوابت الموجودة في الكلاس JSplitPane المخصصة لتحديد طريقة تقسيم الـ Frame.الثوابت التي يسمح باستخدامها هي:
إفتراضياً, الـ Split Pane يستخدم الثابت JSplitPane.HORIZONTAL. |
| 3 | publicJSplitPane(int orientation, Component leftComponent, Component rightComponent)ينشئ كائن من الكلاس JSplitPane يضيف Splitter في الـ Frame, فيقسمها إلى قسمين بالعرض أو الطول مع تحديد محتوى كل قسم.
يرمي الإستثناء IllegalArgumentException في حال لم يتم تحديد الـ Orientation بواسطة الثوابت المخصصة لذلك. |
| 4 | publicJSplitPane(int orientation, boolean continuousLayout, Component leftComponent, Component rightComponent)ينشئ كائن من الكلاس JSplitPane يضيف Splitter في الـ Frame, فيقسمها إلى قسمين بالعرض أو الطول مع تحديد محتوى كل قسم, بالإضافة إلى تحديد إذا كان سيتم رسم الـ Frame مباشرةً عند تحريك الـ Splitter.
يرمي الإستثناء IllegalArgumentException في حال لم يتم تحديد الـ Orientation بواسطة الثوابت المخصصة لذلك. |
دوال الكلاس JSplitPane
الجدول التالي يحتوي على أهم الدوال الموجودة في الكلاس JSplitPane.
| الدالة مع تعريفه | |
|---|---|
| 1 | publicvoidsetOrientation(int orientation)تستخدم لتحديد ما إذا كان سيتم تقسيم الـ Frame أفقياً أم عامودياً. مكان الباراميتر orientation نضع إحدى الثوابت الموجودة في الكلاس JSplitPane المخصصة لتحديد طريقة تقسيم الـ Frame.الثوابت التي يسمح باستخدامها هي:
إفتراضياً, الـ Split Pane يستخدم الثابت JSplitPane.HORIZONTAL. |
| 2 | publicvoidsetContinuousLayout(boolean continuousLayout)تستخدم لتحديد إذا كان سيتم رسم الـ Frame مباشرةً عند تحريك الـ Splitter أم لا. بمعنى آخر, لتحديد إذا كان سيتم تحديث الـ Frame لحظة بلحظة أثناء تحريك الـ Splitter. مكان الباراميتر continuousLayout نضع true إذا أردنا أن يتم رسم الـ Frame مباشرةً عند تحريك الـ Splitter, بالتالي لن يظهر خط أسود عند تحريكه. و نضع false إذا لم نرد ذلك. |
| 3 | publicvoidsetDividerLocation(int location)تستخدم لتحديد موقع الـ Splitter في الـ Frame. مكان الباراميتر location نضع عدد صحيح يحدد موقع الـ Splitter الأولي في الـ Frame. |
| 4 | publicvoidsetDividerSize(int size)تستخدم لتحديد موقع الـ Splitter في الـ Frame. مكان الباراميتر location نضع عدد صحيح يحدد موقع الـ Splitter الأولي في الـ Frame. |
| 5 | publicvoidsetOneTouchExpandable(boolean isOneTouchExpandable)تستخدم لإضافة سهمين صغيرين على الـ Splitter يستخدمان لتحريكه بسرعة في إتجاه محدد. مكان الباراميتر isOneTouchExpandable نضع true إذا أردنا إظهار السهمين. و نضع false إذا لم نرد ذلك. |
| 6 | publicvoidsetLeftComponent(Component comp)تستخدم لتحديد الشيء الذي سيتم وضعه في يسار ( أو أعلى ) الـ Splitter. مكان الباراميتر comp نضع أي شيء نريد وضعه في ذلك المكان. |
| 7 | publicvoidsetRightComponent(Component comp)تستخدم لتحديد الشيء الذي سيتم وضعه في يمين ( أو أسفل ) الـ Splitter. مكان الباراميتر comp نضع أي شيء نريد وضعه في ذلك المكان. |
| 8 | publicvoidsetTopComponent(Component comp)تستخدم لتحديد الشيء الذي سيتم وضعه في أعلى ( أو يسار ) الـ Splitter. مكان الباراميتر comp نضع أي شيء نريد وضعه في ذلك المكان. |
| 9 | publicvoidsetBottomComponent(Component comp)تستخدم لتحديد الشيء الذي سيتم وضعه في أسفل ( أو يمين ) الـ Splitter. مكان الباراميتر comp نضع أي شيء نريد وضعه في ذلك المكان. |
أمثلة شاملة
المثال الأول
المثال التالي يعلمك طريقة إضافة الـ Splitter في الـ Frame لتقسيمها إلى قسمين.
ملاحظة: إفتراضياً, إذا لم تحدد محتوى أقسام الـ Frame ستجد أنه يضع زر واحد في كل قسم.
المثال الثاني
المثال التالي يعلمك طريقة تحديد حجم الـ Splitter, إضافة أسهم عليه لجعل المستخدم قادراً على تحريكه بسرعة, بالإضافة إلى إخفاء اللون الأسود الذي يظهر عند تحريكه.
المثال الثالث
المثال التالي يعلمك طريقة تقسيم الـ Frame إلى قسمين بالطول, أي إظهار الـ Splitter بشكل أفقي.
المثال الرابع
المثال التالي يعلمك طريقة وضع إثنين Splitter في الـ Frame.
المثال الخامس
المثال التالي يعلمك طريقة وضع أي محتوى تريده في الـ Split Pane و إضافة Scroll Bar للأقسام أيضاً.
