يعرض مطالبة في مربع حوار، وينتظر حتى يقوم المستخدم بإدخال نص أو النقر فوق زر، وترجع سلسلة تحتوي على محتويات مربع النص.

بناء الجملة

InputBox ( مطالبة [ ,عنوان ] [ ,افتراضي ] [, xpos ] [, ypos ] [, helpfile ] [ ,context ] )

بناء جملة الدالة InputBox على هذه الوسيطات:

الوسيطة

الوصف

مطالبة

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

العنوان

اختياري. تعبير سلسلة معروض في شريط عنوان مربع الحوار. إذا حذفت العنوان،يتم وضع اسم التطبيق في شريط العنوان.

افتراضي

اختياري. يتم عرض تعبير السلسلة في مربع النص كالاستجابة الافتراضية إذا لم يتم توفير أي إدخال آخر. إذا حذفت الخيار الافتراضي،فيعرض مربع النص فارغا.

xpos

اختياري. تعبير رقمي يحدد، في حالة تويب، المسافة الأفقية من الحافة اليمنى لمربع الحوار من الحافة اليمنى للشاشة. إذا تم حذف xpos، يتم توسيط مربع الحوار أفقيا.

ypos

اختياري. تعبير رقمي يحدد، بالويب، المسافة العمودية الحافة العلوية لمربع الحوار من أعلى الشاشة. إذا تم حذف ypos، يتم وضع مربع الحوار عموديا على شكل ثلث المسافة تقريبا أسفل الشاشة.

helpfile

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

سياق

اختياري. تعبير رقمي هو رقم سياق "تعليمات" المعين إلى موضوع "تعليمات" المناسب من قبل كاتب "تعليمات". إذا تم توفير السياق، فيجب أيضا توفير ملف تعليمات.


ملاحظات

عند توفير كل من ملف تعليمات وسياق، يمكن للمستخدم الضغط على F1 (Windows) أو HELP (Macintosh) لعرض موضوع "تعليمات" المطابق للسياب. تقوم تطبيق مضيف ، على سبيل Microsoft Office Excel 2007 ، بإضافة زر تعليمات إلى مربع الحوار تلقائيا. إذا قام المستخدم بالنقر فوق موافق أو الضغط على ENTER، ترجع الدالة InputBox كل ما هو في مربع النص. إذا نقر المستخدم فوق "إلغاءالأمر"، ترجع الدالة سلسلة ذات طول صفري ("").

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

مثال

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

يوضح هذا المثال طرقا متنوعة لاستخدام الدالة InputBox لمطالبة المستخدم بإدخال قيمة. إذا تم حذف الموضعين س و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)

هل تحتاج إلى مزيد من المساعدة؟

توسيع المهارات
استكشاف التدريب
الحصول على الميزات الجديدة أولاً
الانضمام إلى Microsoft Insider

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

ما مدى رضاك عن جودة الترجمة؟

ما الذي أثّر في تجربتك؟

هل لديك أي ملاحظات إضافية؟ (اختياري)

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

×