يعرض مطالبة في مربع حوار، وينتظر المستخدم لإدخال النص أو ينقر فوق زر، ويرجع سلسلة تحتوي على محتويات مربع النص.
بناء الجملة
InputBox(prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
يحتوي بناء جملة الدالة InputBox على الوسيطات التالية:
| الوسيطة | الوصف |
|---|---|
| مطالبة | مطلوبة. تعبير سلسلة معروض كرسالة في مربع الحوار. يبلغ الحد الأقصى لطول المطالبة حوالي 1024 حرفا، استنادا إلى عرض الأحرف المستخدمة. إذا كانت المطالبة تتكون من أكثر من سطر واحد، فيمكنك فصل السطور باستخدام حرف إرجاع أول السطر (Chr(13)) أو حرف تغذية الأسطر (Chr(10)) أو مجموعة أحرف إرجاع السطر-تغذية الأسطر (Chr(13) & Chr(10)) بين كل سطر. |
| المسمى الوظيفي | اختيارية. تعبير سلسلة معروض في شريط العنوان الخاص بمربع الحوار. إذا حذفت العنوان، فسيتم وضع اسم التطبيق في شريط العنوان. |
| افتراضي | اختيارية. يتم عرض تعبير سلسلة في مربع النص كاستجابة افتراضية إذا لم يتم توفير إدخال آخر. إذا قمت بحذف الإعداد الافتراضي، فسيظهر مربع النص فارغا. |
| XPOS | اختيارية. تعبير رقمي يحدد، بالتويب، المسافة الأفقية للحافة اليسرى لمربع الحوار من الحافة اليمنى للشاشة. إذا تم حذف xpos ، فسيتم توسيط مربع الحوار أفقيا. |
| ypos | اختيارية. تعبير رقمي يحدد، بالتويب، المسافة العمودية للحافة العلوية لمربع الحوار من أعلى الشاشة. إذا تم حذف ypos ، فسيتم وضع مربع الحوار عموديا على بعد ثلث أسفل الشاشة تقريبا. |
| ملف تعليمات | اختيارية. تعبير سلسلة يحدد ملف "التعليمات" لاستخدامه لتوفير تعليمات تتحسس السياق لمربع الحوار. إذا تم توفير ملف مساعدة ، فيجب أيضا توفير السياق . |
| السياق | اختيارية. تعبير رقمي يمثل رقم سياق التعليمات المعين إلى موضوع التعليمات المناسب من قبل كاتب التعليمات. إذا تم توفير السياق ، فيجب أيضا توفير ملف التعليمات . |
ملاحظات
عند توفير كل من ملف التعليماتوالسياق ، يمكن للمستخدم الضغط على F1 (Windows) أو HELP (Macintosh) لعرض موضوع التعليمات المطابق للسياق. تضيف بعض تطبيقات المضيف أيضا بشكل تلقائي زر " تعليمات " إلى مربع الحوار. إذا نقر المستخدم فوق موافق أو ضغط على ENTER، سترجع الدالة InputBox كل ما يوجد في مربع النص. إذا نقر المستخدم فوق "إلغاء"، ترجع الدالة سلسلة ذات طول صفري ("").
ملاحظة
لتحديد أكثر من الوسيطة المسماة الأولى، يجب استخدام InputBox في تعبير. لحذف بعض الوسيطات الموضعية، يجب تضمين محدد الفاصلة المناظر.
مثال
ملاحظة
توضح الأمثلة التالية استخدام هذه الدالة في وحدة نمطية ل Visual Basic for Applications (VBA). لمزيد من المعلومات حول استخدام VBA، حدد "مرجع المطور" في القائمة المنسدلة بجوار "بحث" وأدخل مصطلح أو أكثر في مربع البحث.
يعرض هذا المثال طرقا متنوعة لاستخدام الدالة InputBox لمطالبة المستخدم بإدخال قيمة. إذا تم تجاهل المواضع س وص، يتم توسيط مربع الحوار تلقائيا للمحورين المعنيين. يحتوي المتغير MyValue على القيمة التي يدخلها المستخدم إذا نقر المستخدم فوق OK أو ضغط على المفتاح ENTER. إذا نقر المستخدم فوق "إلغاء"، يتم إرجاع سلسلة ذات طول صفري.
Dim Message, Title, Default, MyValue
Message = "Enter a value between 1 and 3" ' Set prompt.
Title = "InputBox Demo" ' Set title.
Default = "1" ' Set default.
' Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)
' Use Helpfile and context.
' The Help button is added automatically.
MyValue = InputBox(Message, Title,,,,"DEMO.HLP", 10)
' Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)