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értelmezés ] [, 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. Az üzenet argumentum maximális hossza körülbelül 1024 karakter, a használt karakterek szélességétől függően. Ha az üzenet egynél több sorból áll, a sorokat kocsivissza (Chr(13)) vagy soremelés (Chr(10)) karakterrel, illetve a kettő kombinációjá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 kihagyja a cím argumentumot, a címsorba az alkalmazás neve 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értelmezés argumentumot, a szövegmező ü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 megadja a súgófájl argumentumot, a környezet argumentumot is meg kell adnia. |
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 megadja a környezet argumentumot, akkor a súgófájl argumentumot is meg kell adnia. |
Megjegyzések
Ha a súgófájl és a környezet argumentum egyaránt meg van adva, akkor a felhasználó az F1 (Windows) vagy a HELP (Macintosh) billentyűt lenyomva megtekintheti a környezet argumentumnak megfelelő súgótémakört. Néhány gazdaalkalmazás automatikusan hozzáad 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, akkor az InputBox függvényt egy kifejezésben kell használnia. Ha ki szeretne hagyni egyes pozíciójelző argumentumot, használnia kell a megfelelő elválasztójelet.
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 MyValue változó 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)