الدالة MsgBox

هام: تمت ترجمة هذه المقالة ترجمة آلية، راجع إقرار إخلاء المسؤولية. يرجى الاطلاع على النسخة الإنجليزية من هذه المقالة. هنا للرجوع إليها.

تعرض رسالة في مربع الحوار، ثم تنتظر قيام المستخدم بالنقر فوق زر ما، ثم تُرجع عددًا صحيحًا يشير إلى الزر الذي قام المستخدم بالنقر فوقه.

بناء الجملة

MsgBox ( موجه [، ازرار ] [, العنوان ] [، ملف التعليمات ] [, سياق ] )

يحتوي بناء جمله الداله MsgBox علي الوسيطات التاليه:

الوسيطة

وصف

موجه

مطلوب. عرض الرساله في مربع الحوار تعبير سلسله. الحد الاقصي طول المطالبه تقريبا 1024 حرفا، استنادا الي عرض الاحرف المستخدمه. اذا موجه تتكون من اكثر من سطر واحد، يمكنك فصل الاسطر استخدام حرف ارجاع (Chr(13))، حرف تغذيه الاسطر (Chr(10))، او احرف الرجوع – تغذيه تركيبه احرف (Chr(13) & Chr(10)) بين كل سطر.

ازرار

اختيارية. تعبير رقمي يتكون من مجموع القيم التي تحدد أرقام وأنواع الأزرار التي يتم عرضها ونمط الرمز الذي يتم استخدامه وهوية الزر الافتراضي ونمط مربع الرسالة. وإذا تم حذف هذا الجزء، تكون القيمة الافتراضية لـ buttons هي 0.

العنوان

اختيارية. تعبير سلسلة أحرف يتم عرضه في شريط العنوان لمربع الحوار. في حالة حذف title، يتم وضع اسم التطبيق بدلاً منه في شريط العنوان.

ملف التعليمات

اختياري. تعبير سلسلة أحرف يحدد ملف التعليمات الذي سيتم استخدامه لتوفير تعليمات تتحسس السياق لمربع الحوار. في حالة توفير helpfile، يجب توفير context أيضًا.

سياق

اختيارية. تعبير رقمي وهو رقم محتوى التعليمات الذي يتم تعيينه لموضوع التعليمات الملائم من قبل مؤلف التعليمات. في حالة توفير contex، يجب توفير helpfile أيضًا.


الإعدادات

تتضمن إعدادات وسيطةbuttons ما يلي:

الثابت

قيمة

وصف

فبوكونلي

0

يعرض الزر موافق فقط.

فبوككانسيل

1

يعرض الزرين موافق وإلغاء الأمر.

فبابورتريترييجنوري

2

يعرض الأزرار إحباط وإعادة المحاولة وتجاهل.

فبييسنوكانسيل

3

يعرض الأزرار نعم ولا وإلغاء الأمر.

فبييسنو

4

يعرض الزرين نعم ولا.

فبريتريكانسيل

5

يعرض الزرين إعادة المحاولة وإلغاء الأمر.

فبكريتيكال

16

يعرض الرمز رسالة هامة.

فبكويستيون

32

تعرض ايقونه التحذير الاستعلام    .

فبيكسكلاماتيون

48

عرض رساله تحذير    رمز.

فبينفورميشن

64

يعرض الرمز رسالة معلومات.

vbDefaultButton1

0

الزر الأول هو الافتراضي.

vbDefaultButton2

256

الزر الثاني هو الافتراضي.

vbDefaultButton3

512

الزر الثالث هو الافتراضي.

vbDefaultButton4

768

الزر الرابع هو الافتراضي.

فبابليكاتيونمودال

0

شرط التطبيق؛ يجب أن يستجيب المستخدم لمربع الرسالة قبل استكمال العمل في التطبيق الحالي.

فبسيستيمودال

4096

شرط النظام؛ يتم تعليق كافة التطبيقات حتى يستجيب المستخدم لمربع الرسالة.

فبمسجبوكسهيلببوتون

16384

إضافة الزر "تعليمات" إلى مربع الرسالة

فبمسجبوكسسيتفوريجروند

65536

يحدد إطار مربع الرسالة كإطار أمامي

فبمسجبوكسرايت

524288

محاذاة النص إلى اليمين

فبمسجبوكسرتلريدينج

1048576

يحدد النص الذي ينبغي أن يظهر بترتيب قراءة من اليمين إلى اليسار على النظامين العبري والعربي


تلميح: في Access 2010، يتضمن «منشئ التعبير» IntelliSense، لتتمكن من رؤية الوسيطات التي يحتاجها تعبيرك. 

توضح المجموعة الأولى من القيم (0–5) أرقام وأنواع الأزرار المعروضة في مربع الحوار، وتوضح المجموعة الثانية (16, 32, 48, 64) نمط الرمز، وتحدد المجموعة الثالثة (0, 256, 512) الزر الافتراضي، وتحدد المجموعة الرابعة (0, 4096) شروط مربع الرسالة. عند إضافة أرقام لإنشاء قيمة نهائية للوسيطة buttons، استخدم رقم واحد فقط من المجموعة.

ملاحظة: يتم تعيين هذه الثوابت قبل Visual Basic for Applications. نتيجه ل# ذلك، يمكن استخدام الاسماء في اي مكان في التعليمات البرمجيه بدلا من القيم الفعليه.

القيم المرجعة

الثابت

قيمة

وصف

فبوك

1

موافق

فبكانسيل

2

إلغاء الأمر

فبابورت

3

إحباط

فبريتري

4

إعادة المحاولة

فبيجنوري

5

تجاهل

فبييس

6

نعم

فبنو

7

لا


ملاحظات

عندما يتم توفير كل من ملف التعليمات و# السياق ، يمكنك الضغط المستخدم F1 (Windows) او تعليمات (ماكنتوش) ل# عرض موضوع التعليمات الموافق ل# السياق. اضافه بعض التطبيقات المضيف، علي سبيل المثال، Microsoft Office Excel 2007، ايضا تلقائيا زر تعليمات ل# مربع الحوار.

في حالة عرض مربع الحوار للزر إلغاء الأمر، يكون للضغط على المفتاح ESC نفس تأثير النقر فوق إلغاء الأمر. وفي حالة احتواء مربع الحوار على الزر تعليمات، تتوفر تعليمات تتحسس لسياق مربع الحوار. ولكن، لا يتم إرجاع قيمة حتى يتم النقر فوق أحد الأزرار.

ملاحظة: ل# تحديد اكثر من وسيطه مسماه، يجب ان تستخدم MsgBox في تعبير. ل# حذف بعض الوسائط الموضعيه، يجب ان تقوم ب# تضمين محدد الفاصله المناظر.

مثال

ملاحظة: توضح الأمثلة التالية استخدام هذه الدالة في وحدة نمطية لـ Visual Basic for Applications (VBA). لمزيد من المعلومات حول استخدام VBA، حدد مرجع المطور في القائمة المنسدلة بجوار بحث وأدخل مصطلح أو أكثر في مربع البحث.

يستخدم هذا المثال الدالة MsgBox لعرض رسالة الخطأ الهامة في مربع حوار يحتوي على الزر "نعم" و"لا". تعتمد القيمة المرجعة من قبل الدالة MsgBox على الزر الذي يختاره المستخدم. يفترض هذا المثال أن DEMO.HLP هو ملف "تعليمات" يحتوي على موضوع ذي رقم نص "تعليمات" يساوي 1000.

Dim Msg, Style, Title, Help, Ctxt, Response, MyString
Msg = "Do you want to continue?"
Style = vbYesNo + vbCritical + vbDefaultButton2
Title = "MsgBox Demonstration"
Help = "DEMO.HLP"
Ctxt = 1000
Response = MsgBox(Msg, Style, Title, Help, Ctxt)
If Response = vbYes Then ' User chose Yes.
MyString = "Yes" ' Perform some action.
Else ' User chose No.
MyString = "No" ' Perform some action.
End If

ملاحظة: إقرار إخلاء المسؤولية للترجمة الآلية: تمت ترجمة هذه المقالة بواسطة نظام كمبيوتر دون تدخل العامل البشري. توفر Microsoft هذه الترجمات الآلية لمساعدة المستخدمين الذين لا يتحدثون الإنجليزية على استخدام منتجات Microsoft، وخدماتها، وتقنياتها والاستمتاع بها. قد تحتوي هذه المقالة على أخطاء في المفردات، أو بناء الجملة، أو القواعد نظرًا لترجمتها آليًا.

مشاركة Facebook Facebook Twitter Twitter البريد الإلكتروني البريد الإلكتروني

هل كانت المعلومات مفيدة؟

رائع! هل لديك أي ملاحظات أخرى؟

كيف يمكننا تحسين ذلك؟

نشكرك على ملاحظاتك!

×