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. Maksimalna dolžina argumenta poziv je približno 1024 znakov, odvisno od širine uporabljenih znakov. Če je poziv sestavljen iz več vrstic, lahko te ločite z znakom za prelom vrstice (Chr(13)), znakom za pomik v novo vrstico (Chr(10)) ali kombinacijo teh dveh znakov (Chr(13) & Chr(10)) med vsako vrstico. |
naslov |
Izbirno. Izraz niza, prikazan kot naslovna vrstica v pogovornem oknu. Če izpustite naslov, se ime programa vnese 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, se polje z besedilom prikaže prazno. |
x_lega |
Izbirno. Številski izraz, ki določa v twipih vodoravno razdaljo od levega roba pogovornega okna do levega roba zaslona. Če je argument x_lega opuščen, se pogovorno okno poravna vodoravno sredinsko. |
y_lega |
Izbirno. Številski izraz, ki določa v twipih navpično razdaljo od zgornjega roba pogovornega okna do zgornjega roba zaslona. Če je argument y_lega opuščen, se pogovorno okno poravna navpično, približno na tretjino zaslona od zgoraj. |
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. Nekatere gostiteljska aplikacija, na primer Microsoft Office Excel 2007, 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 uporabiti funkcijo InputBox v izrazu. Č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 vnesel 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)