|
تعرض رسالة في مربع الحوار، ثم تنتظر قيام
المستخدم بالنقر فوق زر، ثم تُرجع عدد صحيح يشير إلى الزر الذي قام
المستخدم بالنقر فوقه.
بناء الجملة
MsgBox(prompt[, buttons] [, title] [, helpfile, context])
يحتوي بناء الدالة MsgBox
على الوسائط المسماة التالية:
| الجزء |
الوصف |
| prompt |
مطلوب. تعبير من سلسلة أحرف يتم عرضه كرسالة
في مربع الحوار. ويكون الحد الأقصى لطول prompt حوالي 1024 حرفاً
تقريباً، استناداً إلى عرض الأحرف المستخدمة. إذا
كان prompt يتكون من
أكثر من سطر واحد، فيمكنك فصل الأسطر باستخدام حرف
إرجاع البادئة (Chr(13))، أو حرف تغذية الأسطر
(Chr(10))، أو تركيبة من حرف
إرجاع البادئة وحرف تغذية الأسطر (Chr(13) & Chr(10)) بين كل سطر. |
| buttons |
اختياري. تعبير رقمي يتكون من مجموع القيم
التي تحدد أرقام وأنواع الأزرار التي يتم عرضها،
ونمط الرمز الذي يتم استخدامه، وهوية الزر
الافتراضي، ونمط مربع الرسالة. وإذا تم حذف هذا
الجزء، تكون القيمة الافتراضية لـ buttons هي 0. |
| title |
اختياري. تعبير سلسلة أحرف يتم عرضه في شريط
العنوان لمربع الحوار. في حالة حذف title، يتم وضع اسم
التطبيق بدلاً منه في شريط العنوان. |
| helpfile |
اختياري. تعبير سلسلة أحرف يحدد ملف التعليمات
الذي سيتم استخدامه لتوفير تعليمات تتبع السياق
لمربع الحوار. في حالة توفير helpfile، يجب توفير context أيضاً. |
| context |
اختياري. تعبير رقمي وهو رقم محتوى التعليمات
الذي يتم تعيينه لموضوع التعليمات الملائم من قبل
مؤلف التعليمات. في حالة توفير contex، يجب توفير helpfile
أيضاً. |
الإعدادات
إعدادات الوسيطة buttons ما يلي:
| الثابت |
القيمة |
الوصف |
| vbOKOnly |
0 |
يعرض الزر موافق
فقط: |
| vbOKCancel |
1 |
يعرض الزرين موافق و إلغاء الأمر. |
| vbAbortRetryIgnore |
2 |
يعرض الأزرار إحباط، إعادة المحاولة، وتجاهل. |
| vbYesNoCancel |
3 |
يعرض الأزرار نعم، ولا، وإلغاء
الأمر. |
| vbYesNo |
4 |
يعرض الزرين نعم و لا. |
| vbRetryCancel |
5 |
يعرض الزرين إعادة
المحاولة وإلغاء
الأمر. |
| vbCritical |
16 |
يعرض الرمز رسالة
هامة. |
| vbQuestion |
32 |
يعرض الرمز استعلام
تحذير . |
| vbExclamation |
48 |
يعرض الرمز رسالة
تحذير . |
| vbInformation |
64 |
يعرض الرمز رسالة
معلومات. |
| vbDefaultButton1 |
0 |
الزر الأول هو الافتراضي. |
| vbDefaultButton2 |
256 |
الزر الثاني هو الافتراضي. |
| vbDefaultButton3 |
512 |
الزر الثالث هو الافتراضي. |
| vbDefaultButton4 |
768 |
الزر الرابع هو الافتراضي. |
| vbApplicationModal |
0 |
شرط التطبيق؛ يجب أن يستجيب المستخدم لمربع
الرسالة قبل استكمال العمل في التطبيق
الحالي. |
| vbSystemModal |
4096 |
شرط النظام؛ يتم تعليق كافة التطبيقات حتى
يستجيب المستخدم لمربع الرسالة. |
| vbMsgBoxHelpButton |
16384 |
إضافة الزر "تعليمات" إلى مربع
الرسالة |
| VbMsgBoxSetForeground |
65536 |
يحدد إطار مربع الرسالة كإطار أمامي |
| vbMsgBoxRight |
524288 |
محاذاة النص إلى اليمين |
| vbMsgBoxRtlReading |
1048576 |
يحدد النص الذي ينبغي أن يظهر بترتيب قراءة من
اليمين إلى اليسار على النظامين العبري
والعربي |
توضح المجموعة الأولى من القيم (0–5) أرقام
وأنواع الأزرار المعروضة في مربع الحوار، وتوضح
المجموعة الثانية (16, 32, 48, 64) نمط الرمز،
وتحدد المجموعة الثالثة (0, 256, 512) الزر
الافتراضي، وتحدد المجموعة الرابعة (0, 4096) شروط
مربع الرسالة. عند إضافة أرقام لإنشاء قيمة نهائية
للوسيطة buttons،
استخدم رقم واحد فقط من المجموعة.
ملاحظة يتم تحديد هذه
الثوابت من قِبَل Visual Basic for Applications.
ونتيجة لذلك، يمكن استخدام الأسماء في أي مكان في
التعليمات البرمجية بدلاً من القيم الفعلية.
القيم المرجعة
| الثابت |
القيمة |
الوصف |
| vbOK |
1 |
موافق |
| vbCancel |
2 |
إلغاء الأمر |
| vbAbort |
3 |
إحباط |
| vbRetry |
4 |
إعادة المحاولة |
| vbIgnore |
5 |
تجاهل |
| vbYes |
6 |
نعم |
| vbNo |
7 |
لا |
تنويهات
عند توفير كل من helpfile و context، يمكن أن يقوم
المستخدم بالضغط على F1 في (Windows) أو HELP في
(ماكنتوش) لعرض موضوع التعليمات المتصل بالسياق. تقوم بعض التطبيقات
المضيفة، على سبيل المثال، Microsoft Excel،
بإضافة زر تعليمات تلقائياً
إلى مربع الحوار.
في حالة عرض مربع الحوار للزر إلغاء الأمر، يكون للضغط على
المفتاح ESC نفس تأثير النقر فوق إلغاء الأمر. وفي حالة احتواء
مربع الحوار على الزر تعليمات،
تتوفر تعليمات تتبع سياق مربع الحوار. ولكن، لا
يتم إرجاع قيمة حتى يتم النقر فوق أحد
الأزرار.
ملاحظة لتحديد أكثر من
الوسيطة المسماة الأولى، يجب أن تستخدم MsgBox في تعبير. ولحذف بعض
الوسائط الموضعية، يجب أن تقوم بتضمين محدد
الفاصلة المتصل. |
نسخة سهلة
الطباعة
