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(üzenet [, cím ] [, alapértelmezett ] [, xpoz ] [, ypoz ] [, súgófájl ] [, környezet] )
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 parancs maximális hossza körülbelül 1024 karakter, a használt karakterek szélességétől függően. Ha a parancssor egynél több sorból áll, a sorokat kocsivissza (Chr(13)), soremelés (Chr(10)) vagy kocsivissza–soremelés kombiná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 megjelenik a címsorban. |
| 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 nem adja meg az alapértelmezett beállítást, a beviteli mező ü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 kihagyja az xpoz argumentumot, a párbeszédpanel vízszintesen középre kerül. |
| 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 kihagyja az ypoz argumentumot, a párbeszédpanel függőlegesen körülbelül a képernyő egyharmadánál lesz elhelyezve. |
| 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 meg van adva súgófájl , akkor a kontextust 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, akkor 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űt lenyomva tekintheti meg a környezetnek megfelelő súgótémakört. Egyes gazdaalkalmazások emellett automatikusan elhelyeznek egy Súgó gombot is a párbeszédpanelen. 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őként elnevezett argumentumnál többet szeretne megadni, az InputBox függvényt egy kifejezésben kell használnia. 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 beírt é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)