Megjelenít egy kérdést egy párbeszédpanelen, megvárja, amíg a felhasználó szöveget ír be vagy rákattint egy gombra, és visszaad egy karakterláncot a szövegmező tartalmával.
Szintaxis
InputBox(prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
Az InputBox függvény argumentumai a következők:
| Argumentum | Leírás: |
|---|---|
| üzenet | Kötelező. A párbeszédpanelen üzenetként megjelenő karakterlánc-kifejezés. A parancssor maximális hossza a használt karakterek szélességétől függően körülbelül 1024 karakter lehet. Ha a parancssor több sorból áll, a sorokat kocsivissza karakterrel (Chr(13)), sortörés karakterrel (Chr(10)) vagy kocsivissza–sortörés karakterkombinációval (Chr(13) & Chr(10)) választhatja el egymástól. |
| cím | Nem kötelező. A párbeszédpanel címsorában megjelenő karakterlánc-kifejezés. Ha nem adja meg a címet, az alkalmazás neve a címsorba kerül. |
| alapértelmezés | Nem kötelező. A szövegmezőben alapértelmezett válaszként megjelenő karakterlánc-kifejezés, ha nincs más bemenet megadva. Ha kihagyja az alapértelmezett értéket, a szövegdoboz üresen jelenik meg. |
| xpoz | Nem kötelező. Numerikus kifejezés, amely a párbeszédpanel bal széle és a képernyő bal széle közötti vízszintes távolságot adja meg twipekben. Ha nem adja meg az xpos paramétert, a párbeszédpanel vízszintesen középre van igazítva. |
| ypoz | Nem kötelező. Numerikus kifejezés, amely a párbeszédpanel felső széle és a képernyő teteje közötti függőleges távolságot adja meg twipekben. Ha nem adja meg az ypos értéket, a párbeszédpanel függőlegesen a képernyő felé vezető út körülbelül egyharmadát helyezi el. |
| súgófájl | Nem kötelező. Karakterlánc-kifejezés, amely a párbeszédpanel környezetfüggő súgóját biztosító súgófájlt azonosítja. Ha a súgófájl meg van adva, a környezetet is meg kell adni. |
| környezet | Nem kötelező. Numerikus kifejezés, amely a súgó szerzője által a megfelelő súgótémakörhöz rendelt környezetfüggő szám. Ha a környezet meg van adva, a súgófájlt is meg kell adni. |
Megjegyzések
Ha a súgófájl és a környezet is meg van adva, a felhasználó az F1 (Windows) vagy a HELP (Macintosh) billentyű lenyomásával megtekintheti a környezetnek megfelelő súgótémakört. Egyes gazdaalkalmazások automatikusan hozzáadnak egy Súgó gombot a párbeszédpanelhez. Ha a felhasználó az OK gombra kattint vagy lenyomja az ENTER billentyűt, az InputBox függvény a szövegmező tartalmát adja vissza. Ha a felhasználó a Mégse gombra kattint, a függvény egy nulla hosszúságú karakterláncot ad vissza ("").
Megjegyzés
Ha az első elnevezett argumentumnál többet szeretne megadni, az InputBox értéket kell használnia egy kifejezésben. Ha ki szeretne hagyni egyes pozíciófüggő argumentumokat, az argumentumhoz tartozó elválasztó karaktert szerepeltetnie kell.
Példa
Megjegyzés
A következő példák egy Visual Basic for Applications (VBA) modulban mutatják be a függvény használatát. A VBA használatáról a Keresés elem mellett található legördülő listából a fejlesztői forrásokat választva, majd egy vagy több keresőszót megadva kaphat további tájékoztatást.
Ebben a példában az látható, hogy hogyan lehet az InputBox függvénnyel érték megadását kérő üzenetet megjeleníteni a felhasználó számára. Ha kihagyja az x és az y pozíciót, a párbeszédpanel automatikusan a megfelelő tengelyek közepére kerül. A változó MyValue a felhasználó által megadott értéket tartalmazza, ha a felhasználó az OK gombra kattint, vagy lenyomja az ENTER billentyűt. Ha a felhasználó a Mégse gombra kattint, a program egy nulla hosszúságú karakterláncot ad vissza.
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)