Prikaže poziv v pogovornem oknu, počaka, da uporabnik vnese besedilo ali klikne gumb in vrne niz, ki vsebuje vsebino v polju z besedilom.
Sintaksa
InputBox(poziv [, naslov ] [, privzeto ] [, x_lega ] [, y_lega ] [, datoteka s pomočjo ] [, kontekst ] )
Sintaksa funkcije InputBox ima te argumente:
| Argument | Opis |
|---|---|
| poziv | Obvezno. Izraz niza, prikazan kot sporočilo v pogovornem oknu. Največja dolžina poziva je približno 1024 znakov, odvisno od širine uporabljenih znakov. Če je poziv sestavljen iz več vrstic, lahko vrstice ločite z znakom za prelom vrstice (Chr(13)), znakom za pomik v novo vrstico (Chr(10)) ali kombinacijo znakov za prelom vrstice (Chr(13) & Chr(10)) med vsako vrstico. |
| naslov | Izbirno. Izraz niza, prikazan kot naslovna vrstica v pogovornem oknu. Če izpustite naslov, je ime programa postavljeno v naslovno vrstico. |
| privzeto | Izbirno. Izraz niza, ki je prikazan v polju z besedilom kot privzeti odgovor, če ni na voljo drug vnos. Če izpustite argument privzeto, je polje z besedilom prikazano prazno. |
| x_lega | Izbirno. Številski izraz, ki določa v twipih vodoravno razdaljo od levega roba pogovornega okna do levega roba zaslona. Če izpustite argument »x_ lega«, je pogovorno okno vodoravno usredinjeno. |
| y_lega | Izbirno. Številski izraz, ki določa v twipih navpično razdaljo od zgornjega roba pogovornega okna do zgornjega roba zaslona. Če izpustite argument »y_ lega«, se pogovorno okno pomakne navpično, približno na tretjino zaslona navzdol. |
| datoteka s pomočjo | Izbirno. Izraz niza, ki prepozna datoteke s pomočjo za omogočanje kontekstne pomoči v pogovornem oknu. Če je na voljo datoteka s pomočjo, mora biti naveden tudi kontekst. |
| kontekst | Izbirno. Številski izraz, ki je številka konteksta pomoči, ki jo avtor pomoči dodeli ustrezni temi pomoči. Če je na voljo kontekst, mora biti na voljo tudi datoteka s pomočjo. |
Opombe
Ko sta na voljo tako datoteka s pomočjo kot kontekst, lahko uporabnik pritisne tipko F1 (Windows) ali pomoč (Macintosh), da si ogleda temo pomoči, ki ustreza kontekstu. Nekateri gostiteljski programi tudi samodejno dodajo gumb »Pomoč« v pogovorno okno. Če uporabnik klikne V redu ali pritisne ENTER , funkcija InputBox vrne element, ki je v polju z besedilom. Če uporabnik klikne Prekliči, funkcija vrne niz ničelne dolžine ("").
Opomba
Če želite določiti več prvih imenovanih argumentov, morate v izrazu uporabiti InputBox . Če želite izpustiti nekatere argumente položaja, morate vključiti ustrezno vejico kot ločilo.
Primer
Opomba
V spodnjih primerih je prikazana uporaba te funkcije v modulu Visual Basic for Applications (VBA). Če želite več informacij o delu z modulom VBA, izberite Vsebina za razvijalce na spustnem seznamu ob možnosti Iskanje in v iskalno polje vnesite enega ali več izrazov.
V tem primeru so prikazani različni načini za uporabo funkcije InputBox za poziv uporabnika k vnosu vrednosti. Če sta položaja x in y izpuščena, se pogovorno okno samodejno poravna na sredino za ustrezni osi. Spremenljivka MyValue vsebuje vrednost, ki jo je vnel uporabnik, če uporabnik klikne V redu ali pritisne tipko ENTER. Če uporabnik klikne Prekliči, se vrne niz ničelne dolžine ("").
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)