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 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)