خلف كواليس JOptionPane:

من ضمن أدوات Swing المتوفرة بـ J2SE كلاس مميز لانشاء Panel لتكون على شكل نافذة منبثقة (Popup window). تستطيع استخدام النافذة لإظهار الرسائل للمستخدم و جمع المعلومات المطلوبه منه. الـ Panel ينقسم إلى أربع أقسام رئيسية و هي على الشكل التالي: قسم خاص للايقونة و قسم لاظهار الرسائل و قسم لجمع المعلومات و اخيراً قسم للأزرار. و تستطيع على الأقل استخدام قسم خاص بالرسالة و قسم الأزرار.

قسم الأيقونه خاص لإظهار الـ javax.swing.Icon. يمثل شكل الأيقونة محتوى الرسالة الظاهره للمستخدم و توجد هناك عدة أشكال جاهزه للايقونة من خلال الـ Java Look And Feel و تستطيع التعامل معها من خلال الخصائص التالية:

·          OptionPane.informationIcon

·          OptionPane.warningIcon

·          OptionPane.errorIcon

·          OptionPane.questionIcon

لا يجب على المستخدم تغيير الخصائص بشكل يدوي عن طريق الـ

UIManager.put(property name, new resource). بل تستطيع عمل ذلك بتعريف الجزء المخصص للرسالة من خلال الـ JOptionPane:

·          JOptionPane.PLAIN_MESSAGE

·          JOptionPane.INFORMATION_MESSAGE

·          JOptionPane.WARNING_MESSAGE

·          JOptionPane.ERROR_MESSAGE

·          JOptionPane.QUESTION_MESSAGE

الـ Plain عبارة عن مساحة فارغه أما البقية فتستخدم الايقونات الافتراضية للـ Java Look And Feel:

القسم الثاني من الـ JOptionPane هو قسم الرسائل التي تظهر للمستخدم. و تستطيع استعراض اي عدد من الـ Objects بالقسم و سوف يتم عرضه كرسالة للمستخدمين.

القسم التالي هو قسم ادخال المعلومات المطلوبة من المستخدم، و باستخدام هذا القسم تستطيع استخدام الـ JTextField أو JComboBox أو JList لعرض المعلومات للمستخدم و الاختيار من بينها.

القسم الأخير هو قسم الأزرار و هو قسم خاص لعرض الأزرار مثل Yes/No. و بالضغط على أحد الأزرار ينتهي عمل الـ JOptionPane و يوجد خيارات افتراضية لهذا القسم (مثل القسم الخاص بالأيقونات،كـ OptionPane.yesButtonText). و تستطيع ايضاً انتاج أزرار اخرى لاستخدامها أو الغاء هذه الخاصية بالـ JOptionPane. و تستطيع كذلك استخدام لغتك الأم لتسمية الأزرار باسماء لغات اخرى مثل "موافق/غير موافق".

الخصائص المتوفرة بشكل افتراضي لهذا القسم كتالي:

·          DEFAULT_OPTION

·          YES_NO_OPTION

·          YES_NO_CANCEL_OPTION

·          OK_CANCEL_OPTION

الخاصية الافتراضية للـ JOptionPane هو الـ OK button.

استخدام JOptionPane:

الـ JOptionPane يحتوى على سبع من الـ constructors. كل واحد منها يرجع أداه لتستخدمها في كل مكان. أيضاً تستطيع إنشاء أدوات لتستخدمها بشكل افتراضي من خلال الـ JDialog و الـ JInternalFrame. توجد هناك ثمانية طرق لعرض الـ JOptionPane من خلال الـ JDialog أو الـ JInternalFrame:

·          show[Internal]MessageDialog

·          show[Internal]ConfirmDialog

·          show[Internal]InputDialog

·          show[Internal]OptionDialog

خيار الـ Internal لعرض الـ JOptionPane بداخل الـ JInternalFrame. أما الخيار الاخر فهو للـ JDialog.

الـ Message Dialog لعرض رسالة للمستخدم للموافقة عليها عبر الضغط على الزر – لا تستطيع اعادة اي قيمة –. تستطيع استخدام هذه الخاصية بالكود التالي:

JOptionPane.showMessageDialog(component, "Hello, World");

النظام سوف يقوم بعرض الـ MessageDialog بوسط الشاشة فوق الـ component.

توجد هناك طريقتين لعرض المعلومات على المستخدم و تستطيع أيضاً تغيير عنوان النافذة و نوع الرسالة و تخصيص شكل الأيقونة التي سوف تظهر.

·          showMessageDialog(Component parentComponent,

Object message,

String title,

int messageType)

·          showMessageDialog(Component parentComponent,

Object message,

String title,

int messageType,

Icon icon)

و توجد هناك اربع طرق لعرض نوافذ الموافقة:

·          showConfirmDialog(Component parentComponent, Object message)

·          showConfirmDialog(Component parentComponent,

Object message,

String title,

int optionType)

·          showConfirmDialog(Component parentComponent,

Object message,

String title,

int optionType,

int messageType)

·          showConfirmDialog(Component parentComponent, Object message,

String title, int optionType,

int messageType, Icon icon)

أسهل طريقة لعرض نافذة للسؤال (مع عدم تغيير الخصائص) هي:

JOptionPane.showConfirmDialog(component, "Lunch?");

اذا كانت الخصائص الافتراضية لا تعجبك فتستطيع تغييرها بكل سهولة مع الـ JOptionPane.

بعكس الـ MessageDialog، تستطيع من خلال الـ ConfirmDialog استرجاع القيم المطلوبة من المستخدم و تستطيع معرفة الزر الذي قام المستخدم بالضغط عليه. الـ ConfirmDialog يقوم باعادة قيم عددية (integer) عن طريق أحد الثوابت التالية من الـ JOptionPane:

·          CANCEL_OPTION

·          CLOSED_OPTION

·          NO_OPTION

·          OK_OPTION

·          YES_OPTION

بالمثال التالي تستطيع معرفة الزر الذي قام المستخدم بالضغط عليه:

int returnValue = JOptionPane.showConfirmDialog(component, "Lunch?");

String message = null;

if(returnValue == JOptionPane.YES_OPTION) {

    message = "Yes";

}

else if(returnValue == JOptionPane.NO_OPTION) {

    message = "No";

}

else if(returnValue == JOptionPane.CANCEL_OPTION) {

    message = "Cancel";

}

else if(returnValue == JOptionPane.CLOSED_OPTION) {

    message = "Closed";

}

System.out.println("User selected: " + message);

و توجد هناك ست طرق لعرض نوافذ لادخال البيانات InputDialog (خمسة طرق لاعادة الـ String):

·          showInputDialog(Object message)

·          showInputDialog(Object message, Object initialSelectionValue)

·          showInputDialog(Component parentComponent, Object message)

·          showInputDialog(Component parentComponent, Object message, Object initialSelectionValue)

·          showInputDialog(Component parentComponent ,Object message, String title,int messageType)

و اخيراً طريقة لاعادة قيم الـ Object:

·          showInputDialog(Component parentComponent,

Object message,

String title,

int messageType,

Icon icon,

Object[] selectionValues,

Object initialSelectionValue)

التعديل البسيط الذي حصل هو وجود مكان لادخال البيانات و أزرار للموافقة و الالغاء.

String value = JOptionPane.showInputDialog("Name");

كما فعلنا سابقاً، تستطيع التعديل على الأيقونة و العنوان و محتوى الرسالة. أما الأزرار فهي ثابتة لا تتغير و تستطيع ايضاً اضافة نص جاهزاً بالـ text field.

بالنسبة للطريقة الأخيرة للـ InputDialog فهي مميزة عن الطريق الأخرى. و هذا عن طريق استخدام مصفوفة (Array). بالمثال التالي نستطيع إيضاح ذلك:

String smallList[] = {

    "Sunday",

    "Monday",

    "Tuesday",

    "Wednesday",

    "Thursday",

    "Friday",

    "Saturday"

};

String value =

    (String)JOptionPane.showInputDialog(

        component,

        "Which Day?",

        "Day",

        JOptionPane.QUESTION_MESSAGE,

        null, // Use default icon

        smallList,

        smallList[smallList.length-1]);

System.out.println("Day: " + value);

لاستخدام مجموعة (List) أكبر – الكود يشبه الكود السابق – ، هنا مجموعة (List) لخصائص النظام:

Object largeList[] = System.getProperties().keySet().toArray();

String value =

    (String)JOptionPane.showInputDialog(

        component,

        "Which Property?",

        "Property",

        JOptionPane.QUESTION_MESSAGE,

        null,

        largeList,

        largeList[largeList.length-1]);

System.out.println("Property: " + value);

اخيراً، النافذة التي تشمل الجميع، showOptionDialog و التي لها منهج واحد فقط (Method):

·          showOptionDialog(Component parentComponent,

Object message,

String title,

درس خلف كواليس JOptionPane