دالة InputBox لغة VBScript
التعريف والاستخدام
تظهر دالة InputBox نافذة حوار يمكن للمستخدم فيها إدخال النص وتحديد زر أو زر المساعدة. إذا ضغط المستخدم على زر الاعتماد أو ضغط على مفتاح Enter على لوحة المفاتيح، فإن دالة InputBox تعود بنص النص box. إذا ضغط المستخدم على زر الإلغاء، تعود الدالة بنص فارغ ("").
تعليق:إذا تم تحديد معلمتي helpfile و context معًا، فإنه سيتم إضافة زر المساعدة إلى نافذة الحوار.
نصيحة:انظر إلى دالة MsgBox.
القواعد النحوية
InputBox(prompt[,title][,default][,xpos][,ypos][,helpfile,context])
| معلمة | وصف |
|---|---|
| prompt | ضروري. الرسالة في نافذة الحوار الحالية. أقصى طول prompt حوالي 1024 حرف، يعتمد ذلك على عرض الحرف المستخدم. إذا كان يحتوي prompt على عدة أسطر، يمكن فصل الأسطر بينها باستخدام رمز النقطة السفلية (Chr(13))، رمز النقلة (Chr(10)) أو مزيج من كلاهما (Chr(13) & Chr(10)). |
| title | اختياري. تعبير نصي، يستخدم لتحديد النص الذي سيتم عرضه في شريط العنوان للنافذة الحوارية. إذا تم تمرير title، سيتم عرض اسم التطبيق في شريط العنوان. |
| default | اختياري. تعبير نصي، يستخدم لتحديد النص الذي سيتم عرضه في مربع النص عند عدم إدخال أي إدخال آخر. إذا تم تمرير default، سيكون مربع النص فارغًا. |
| xpos | اختياري. تعبير عددى، يستخدم لتحديد المسافة الفاصلة بين الوجهة اليسرى للنافذة الحوارية والوجهة اليسرى للشاشة (بأsein). إذا تم تمرير xpos، يتم عرض النافذة الحوارية في منتصف الشاشة في الاتجاه الأفقي. |
| ypos | اختياري. تعبير عددى، يستخدم لتحديد المسافة الفاصلة بين الوجهة العلوية للنافذة الحوارية والوجهة العلوية للشاشة (بأsein). إذا تم تمرير ypos، يتم عرض النافذة الحوارية في منتصف الشاشة في الاتجاه العمودي. |
| ملف المساعدة | اختياري. تعبير نصي، يستخدم لتحديد ملف المساعدة الذي يقدم المساعدة المتعلقة بالسياق للنافذة الحوارية. إذا تم تقديم ملف المساعدة، يجب تقديم السياق. |
| سياق | اختياري. تعبير عددى، يستخدم لتحديد الرقم المحدد للسياق الذي يحدده مؤلف ملف المساعدة لمنظور معين. إذا تم تقديم السياق، يجب تقديم ملف المساعدة. |
مثال
dim fname
fname=InputBox("أدخل اسمك:")
MsgBox("اسمك هو " & fname)
