הפונקציה InputBox

חשוב: מאמר זה תורגם בתרגום מכונה, ראה כתב ויתור. תוכל למצוא את הגרסה באנגלית של המאמר כאן לעיונך.

הצגת בקשה בתיבת דו-שיח, המתנה שהמשתמש מזין טקסט, או לחץ על לחצן והחזרת מחרוזת המכילה את התוכן של תיבת הטקסט.

תחביר

InputBox ( שורת [כותרת ] [ברירת המחדל ] [, xpos ] [, ypos ] [, קובץ עזרה ] [הקשר ] )

תחביר הפונקציה InputBox כולל את הארגומנטים הבאים:

ארגומנט

תיאור

שורת

נדרש. ביטוי מחרוזת המוצג כהודעה בתיבת הדו-שיח. האורך המרבי של prompt הוא כ- 1024 תווים, בהתאם לרוחב התווים המשמשים. אם prompt מכיל יותר משורה אחת, באפשרותך להפריד בין השורות באמצעות גררה (Chr(13)), תו הזנת שורה (Chr(10)) או גררה התשואה-הזנת שורה צירוף התווים (Chr(13) & Chr(10)) בין כל שורה.

כותרת

אופציונלי. ביטוי מחרוזת המוצג בפס הכותרת של תיבת הדו-שיח. אם תשמיט את title, שם היישום ממוקמת בפס הכותרת.

ברירת מחדל

אופציונלי. ביטוי מחרוזת המוצג בתיבת הטקסט בתור תגובת ברירת מחדל אם סופק קלט לא אחר. אם תשמיט את default, תוצג תיבת הטקסט ריקה.

xpos

אופציונלי. ביטוי מספרי המציין, בטוויפים, המרחק האופקי של השוליים השמאליים של תיבת הדו-שיח מהקצה השמאלי של המסך. אם xpos מושמט, תיבת הדו-שיח ממורכזת אופקית.

ypos

אופציונלי. ביטוי מספרי המציין, בטוויפים, המרחק האנכי של השוליים העליונים של תיבת הדו-שיח בחלק העליון של המסך. אם ypos מושמט, תיבת הדו-שיח אנכית ממוקם בשליש הדרך בכיוון המסך.

קובץ עזרה

אופציונלי. ביטוי מחרוזת המזהה את קובץ העזרה לשימוש כדי לספק עזרה תלויית-הקשר עבור תיבת הדו-שיח. אם קובץ עזרה סופק, יש לספק גם ההקשר .

הקשר

אופציונלי. ביטוי מספרי שהוא מספר הקשר העזרה שהוקצה לנושא העזרה המתאים על-ידי מחבר העזרה. אם סופק ההקשר , יש לספק גם קובץ עזרה .


הערות

כאשר קובץ עזרהוהקשר ניתנים, המשתמש באפשרותך להקיש F1 (Windows) או עזרה (Macintosh) כדי להציג את נושא העזרה המתאים ההקשר. כמה יישום מארח, לדוגמה, Microsoft Office Excel 2007, מוסיפים אוטומטית לחצן עזרה לתיבת הדו-שיח. אם המשתמש לוחץ על OK או מקיש ENTER, הפונקציה InputBox מחזירה את כל מה שנמצא בתיבת הטקסט. אם המשתמש לוחץ על ביטול, הפונקציה מחזירה מחרוזת באורך אפס ("").

הערה: כדי לציין יותר מאשר הארגומנט הנקוב הראשון, עליך להשתמש ב- InputBox ב- ביטוי. כדי להשמיט מספר ארגומנטים של מיקום, עליך לכלול את הפסיק המפריד המתאים.

דוגמה

הערה: הדוגמאות הבאות מדגימות את השימוש של פונקציה זו במודול Visual Basic for Applications‏ (VBA). לקבלת מידע נוסף אודות עבודה עם VBA, בחר הפניית מפתח ברשימה הנפתחת שליד חיפוש והזן מונח אחד או יותר בתיבת החיפוש.

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

הרחב את הכישורים שלך
סייר בהדרכה
קבל תכונות חדשות לפני כולם
הצטרף למשתתפי Office Insider

האם מידע זה היה שימושי?

תודה על המשוב!

תודה על המשוב! נראה שכדאי לקשר אותך לאחד מנציגי התמיכה של Office.

×