يعرض مطالبة في مربع حوار، وينتظر المستخدم لإدخال النص أو النقر فوق زر، وإرجاع سلسلة تحتوي على محتويات مربع النص.
بناء الجملة
InputBox ( prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
يحتوي بناء جملة الدالة InputBox على هذه الوسيطات:
|
الوسيطة |
الوصف |
|
موجه |
مطلوبة. يتم عرض تعبير السلسلة كرسالة في مربع الحوار. يبلغ الحد الأقصى لطول المطالبة حوالي 1024 حرفا، اعتمادا على عرض الأحرف المستخدمة. إذا كانت المطالبة تتكون من أكثر من سطر واحد، يمكنك فصل الأسطر باستخدام حرف إرجاع حرف (Chr(13)) أو حرف ملف خطي (Chr(10)) أو تركيبة حرف إرجاع سطري (Chr(13) & Chr(10)) بين كل سطر. |
|
عنوان |
اختيارية. تعبير السلسلة المعروض في شريط العنوان لمربع الحوار. إذا حذفت العنوان، يتم وضع اسم التطبيق في شريط العنوان. |
|
افتراضي |
اختيارية. يتم عرض تعبير السلسلة في مربع النص كاستجابة افتراضية إذا لم يتم توفير إدخال آخر. إذا حذفت الإعداد الافتراضي، فسيتم عرض مربع النص فارغا. |
|
xpos |
اختيارية. التعبير الرقمي الذي يحدد، بالتويب، المسافة الأفقية للحافة اليسرى لمربع الحوار من الحافة اليسرى للشاشة. إذا تم حذف xpos ، يتم توسيط مربع الحوار أفقيا. |
|
المستودعات |
اختيارية. التعبير الرقمي الذي يحدد، بالتويب، المسافة العمودية للحافة العليا لمربع الحوار من أعلى الشاشة. إذا تم حذف المستودعات ، يتم وضع مربع الحوار عموديا حوالي ثلث الطريق لأسفل الشاشة. |
|
ملف التعليمات |
اختيارية. تعبير سلسلة يحدد ملف التعليمات المراد استخدامه لتوفير تعليمات حساسة للسياق لمربع الحوار. إذا تم توفير ملف المساعدة ، يجب أيضا توفير السياق . |
|
سياق |
اختيارية. تعبير رقمي هو رقم سياق التعليمات المعين لموضوع التعليمات المناسب بواسطة مؤلف التعليمات. إذا تم توفير السياق ، يجب أيضا توفير ملف المساعدة . |
ملاحظات
عند توفير كل من ملف المساعدةوالسياق ، يمكن للمستخدم الضغط على F1 (Windows) أو HELP (Macintosh) لعرض موضوع التعليمات المطابق للسياق. بعض تطبيق مضيف ، على سبيل المثال، Microsoft Office Excel 2007 ، إضافة زر تعليمات تلقائيا إلى مربع الحوار. إذا نقر المستخدم فوق موافق أو اضغط على ENTER، فترجع الدالة InputBox كل ما هو موجود في مربع النص. إذا نقر المستخدم فوق إلغاء، ترجع الدالة سلسلة ذات طول صفري ("").
ملاحظة: لتحديد أكثر من الوسيطة المسماة الأولى، يجب استخدام InputBox في تعبير. لحذف بعض الوسيطات الموضعية، يجب تضمين محدد الفاصلة المقابل.
مثال
ملاحظة: توضح الأمثلة التالية استخدام هذه الدالة في وحدة Visual Basic for Applications (VBA). لمزيد من المعلومات حول العمل مع VBA، حدد مرجع المطور في القائمة المنسدلة بجوار البحث وأدخل مصطلحا واحدا أو أكثر في مربع البحث.
يوضح هذا المثال طرقا مختلفة لاستخدام دالة InputBox لمطالبة المستخدم بإدخال قيمة. إذا تم حذف الموضعين x وy، يتم توسيط مربع الحوار تلقائيا للمحورين المعنيين. يحتوي MyValue المتغير على القيمة التي أدخلها المستخدم إذا نقر المستخدم فوق موافق أو اضغط على المفتاح 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)
