הצגת בקשה בתיבת דו-שיח, המתנה שהמשתמש יקלט טקסט או לחץ על לחצן, והחזרת מחרוזת המכילה את התוכן של תיבת הטקסט.
תחביר
InputBox ( prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
תחביר הפונקציה InputBox מכיל את הארגומנטים הבאים:
|
ארגומנט |
תיאור |
|
בשורת |
נדרש. ביטוי מחרוזת המוצג כהודעה בתיבת הדו-שיח. אורך הבקשה המרבי הוא כ- 1024 תווים, בהתאם לרוחב התווים הנמצאים בשימוש. אם הבקשה כוללת יותר משורה אחת, באפשרותך להפריד בין הקווים באמצעות תו החזרת גררה (Chr(13)), תו הזנה בשורות (Chr(10)) או שילוב תווים של החזרת גררה-שורה (Chr(13) & Chr(10)) בין כל שורה. |
|
כותרת |
אופציונלי. ביטוי מחרוזת המוצג בפס הכותרת של תיבת הדו-שיח. אם השמטת את הכותרת, שם היישום ימוקם בפס הכותרת. |
|
ברירת מחדל |
אופציונלי. ביטוי מחרוזת המוצג בתיבת הטקסט כתשובת ברירת המחדל אם לא סופק קלט אחר. אם השמטת ברירת המחדל, תיבת הטקסט מוצגת ריקה. |
|
xpos |
אופציונלי. ביטוי מספרי המציין, בין טוויפס, את המרחק האופקי של הקצה השמאלי של תיבת הדו-שיח מהקצה השמאלי של המסך. אם xpos מושמט, תיבת הדו-שיח ממורכזת אופקית. |
|
גרש (Ypos) |
אופציונלי. ביטוי מספרי המציין, בין טוויפס, את המרחק האנכי של הקצה העליון של תיבת הדו-שיח מראש המסך. אם ypos מושמט, תיבת הדו-שיח ממוקמת באופן אנכי כשליש מהדרך במורד המסך. |
|
קובץ helpfile |
אופציונלי. ביטוי מחרוזת המזהה את קובץ העזרה שבו יש להשתמש כדי לספק עזרה תלוית הקשר עבור תיבת הדו-שיח. אם סופק קובץ helpfile , יש לספק גם הקשר. |
|
הקשר |
אופציונלי. ביטוי מספרי שהוא מספר הקשר העזרה שהוקצה לנושא העזרה המתאים על-ידי מחבר העזרה. אם סופק הקשר, יש לספק גם קובץ helpfile. |
הערות
כאשר סופקו גם קובץ helpfile וגם הקשר, המשתמש יכול להקיש 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)
