הצגת בקשה בתיבת דו-שיח, המתנה שהמשתמש יזין טקסט או ילחץ על לחצן, והחזרת מחרוזת המכילה את התוכן של תיבת הטקסט.
תחביר
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 כדי לבקש מהמשתמש להזין ערך. אם המיקומים 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)