سوف نتعرف في هذا المثال على احد الدوال الجاهزة داخل لغة البرمجة فيجوال بيسك دوت نت وهى الدالة msgbox وتقدم لنا هذه الدالة طريقة بسيطة لإظهار الرسائل المختلفة للمستخدمين ويتكون مربع الرسالة من عدة مكونات كما نرى
الرسالة الرئيسية التي تظهر داخل مربع الرسالة والعنوان الذي يشهر في شريط العنوان الخاص بشريط الرسالة بالاضافة الى المفتاح ok ويظهر المفتاح داخل مربع الرسالة في الوضع الافتراضي للدالة ولكن يمكننا تحديد اسلوب المفاتيح التي تظهر داخل المربع الرسالة حيث يمكننا اظهار المفاتيح yes , no او ok , cancel
او اظهار المفاتيح retry , abort
وبما ان مربع الرسالة الذي ينتج عن تشغيل الدالة msgbox يتكون من ثلاثة مكونات لذلك هذه الدالة تسمح لنا بإدخال ثلاثة معطيات لتحديد هذه المكونات
والصيغة العامة للدالة هى كما نرى هنا
كود:
Msgbox ( prompt, [ button style ] , [ Title] )
ففي المعطى prompt يتم كتابة الرسالة التي تظهر داخل مربع الرسالة مع ملاحظة انه يجب كتابة هذه الرسالة بين العلامتين " "
وفي المعطى button style يتم تحددي اسلوب المفاتيح المستخدم مع مربع الرسالة ويمكننا تحديد اساليب المفاتيح عن طريق كتابة اسم الاسلوب مباشرة كما يمكن التعبير عن هذه الاساليب باستخدام الارقام حيث يتم التعبير عن كل اسلوب من هذه الاساليب برقم معين
وذلك لان اللغة فيجوال بيسك دوت نت تدعم ما يسمى بتسمية الثوابت Named constants حيث يتم التعبير عن كل ثابت برقم معين بدلا من كتابة اسم كل ثابت فعلى سبيل المثال لأدراج المفاتيح داخل مربع الرسالة كأسلوب للمفاتيح يتم كتابة العبارة msgboxstyle.yesno
كما يمكن كتابة الرقم 4 بدلا من كتابة هذه العبارة ويجب ملاحظة ان عند كتابة
هذا المعطى خالي بدون تحديد اسلوب للمفاتيح سيتم اظهار مفتاح ok فقط وهو الوضع الافتراضي للمربع msgbox وفي المعطى title يتم كتابة العنوان الذي نريد اظهاره في شريط العنوان الخاص بالرسالة بين علامتي ""
واذا قمنا بترك هذا المعطى خالي فان البرنامج يقوم باعطاء اسم للتطبيق كعنوان لمربع السالة مع ملاحظة انه لا يجب كتابة جميع معطيات هذه الدالة ولكن يجب على الاقل كتابة الرسالة التي تظهر داخل مربع الرسالة اما اسلوب المفاتيح والعنوان فهى معطيات خيارية بمعني يمكن ادخالها او اهمالها ..
فإذا اردنا على سبيل المثال اظهار مربع رسالة للمستخدم Do you really want to exit وتظهر به المفاتيح yes,no ويظهر فيه العنوان warning ففي هذه الحالة نكتب الجملة التي نراها هنا
كود:Msgbox (“Do you realy want to exit?”,msgboxstyle.YesNo,”warning”)
Msgbox (“Do you realy want to exit?”,4,”warning”)
ويجب ملاحظة اذا اردنا عدم تحديد كلا من اسلوب المفاتيح وعنوان مربع الرسالة فأننا لا نحتاج الاشارة اليهم داخل الدالة كهذا المثال
كود:Msgbox (“Do you realy want to exit?”(
اما اذا اردنا على سبيل المثال تحديد عنوان الرسالة بدون تحديد اسلوب المفاتيح فيجب كتابة الجملة كما يظهر هنا
كود:Msgbox (“Do you realy want to exit?”, ,”warning”)
ويجب مراعاة الترتيب عند ادخال معطيات الدالة وبمأن الرسالة msgbox عبارة عن دالة فانه يتم توليد قيم مختلفة من هذه الدالة نتيجة لتفاعل المستخدم مع المفاتيح الموجودة داخل مربع الرسالة ويمكننا استخدام هذه القيم لإنجاز المهام المختلفة داخل البرنامج وفقا للمفتاح الذي قام المستخدم بالضغط عليه
كود:Dim msgReturnValue As MsgBoxResult
MsgReturnValue = MsgBox(“Do you really want to exit”,MsgboxStyle.YesNo)
ففي الكود الذي نراه نرى ان الدالة msgbox على يمين العلامة = وهذا يعني ان قمنا بتعين ناتج الدالة Msgbox لمتغير له الاسم msgreaturnValue
يجب تعريف هذا المتغير بنوع البيانات msgboxresult حتى يستطيع التعرف على البيانات الناتجة من الدالة وبالتالي فإن ناتج الدالة يتم تخزينة في المتغير msgreaturnValue
ويمكننا معرفة المفتاح الذي قام المستخدم بالضغط عليه عن طريق اختبار القيمة الذي تم تخزينها في المتغير msgreaturnValue
فاذا كانت قيمة هذا المتغير
MsgReturnValue = MsgBoxResult.Yes
فإن المستخدم قام بالضغط على المفتاح yes
اما اذا كانت قيمة المتغير
MsgReturnValue = MsgBoxResult.No
فإن المستخدم فام بالضغط على المفتاح no
وبالتالي فيمكننا استخدام قيمة هذا المتغيرلإنجاز المهام المختلفة