Prikazuje upit u dijaloškom okviru, čeka da korisnik u unosi tekst ili klikne gumb i vraća niz koji sadrži sadržaj tekstnog okvira.
Sintaksa
InputBox ( prompt [, naslov ] [, zadano ] [, xpos ] [, ypos ] [, helpfile ] [, kontekst ] )
Sintaksa funkcije InputBox sadrži ove argumente:
|
Argument |
Opis |
|
Brz |
Obavezno. Nizovni izraz prikazuje se kao poruka u dijaloškom okviru. Maksimalna duljina upita iznosi približno 1024 znaka, ovisno o širini korištenih znakova. Ako se upit sastoji od više redaka, crte možete razdvojiti znakom za povrat (Chr(13)), znakom sažecima crte (Chr(10)) ili kombinacijom znaka return-linefeed (Chr(13) & Chr(10)) između svakog retka. |
|
Naslov |
Neobavezno. Nizovni izraz prikazan na naslovnoj traci dijaloškog okvira. Ako izostavite naslov, naziv aplikacije smješta se na naslovnu traku. |
|
zadano |
Neobavezno. Nizovni izraz prikazan u tekstnom okviru kao zadani odgovor ako nije naveden nijedan drugi unos. Ako izostavite zadano, tekstni se okvir prikazuje prazan. |
|
xpos |
Neobavezno. Brojčani izraz koji u twipsima određuje vodoravnu udaljenost lijevog ruba dijaloškog okvira od lijevog ruba zaslona. Ako se xpos izostavi, dijaloški je okvir vodoravno centriran. |
|
ypos |
Neobavezno. Brojčani izraz koji u twipsima određuje okomitu udaljenost gornjeg ruba dijaloškog okvira od vrha zaslona. Ako se argument ypos izostavi, dijaloški je okvir okomito postavljen otprilike jednu trećinu puta prema dolje po zaslonu. |
|
datoteka pomoći |
Neobavezno. Nizovni izraz koji identificira datoteku pomoći koja će se koristiti za pružanje kontekstne pomoći za dijaloški okvir. Ako je navedena datoteka pomoći, potrebno je navesti i kontekst. |
|
Kontekstu |
Neobavezno. Brojčani izraz koji je kontekstni broj pomoći koji je autor pomoći dodijelio odgovarajućoj temi pomoći. Ako je kontekst naveden, mora se navesti i datoteka pomoći. |
Napomene
Kada se prikažu i datoteka pomoći i kontekst, korisnik može pritisnuti F1 (Windows) ili HELP (Macintosh) da bi prikazao temu pomoći koja odgovara kontekstu. Neke glavna aplikacija, primjerice Microsoft Office Excel 2007, automatski dodaju gumb Pomoć u dijaloški okvir. Ako korisnik klikne U redu ili pritisne ENTER , funkcija InputBox vraća sve što se nalazi u tekstnom okviru. Ako korisnik klikne Odustani, funkcija vraća niz nulte duljine ("").
Napomena: Da biste odredili više od prvog imenovanog argumenta, morate koristiti InputBox u izraz. Da biste izostavili neke argumente položaja, morate uvrstiti odgovarajući razdjelnik zareza.
Primjer
Napomena: Primjeri koji slijede prikazuju korištenje te funkcije u modulu jezika Visual Basic for Applications (VBA). Da biste pronašli dodatne informacije o radu s VBA-om, na padajućem popisu uz stavku Traži odaberite stavku Referenca za razvojne inženjere pa unesite jedan ili više izraza u okvir pretraživanja.
U ovom se primjeru prikazuju različiti načini korištenja funkcije InputBox za upit korisnika da uđe u vrijednost. Ako se položaji x i y izostave, dijaloški okvir automatski se centriraju za odgovarajuće osi. Varijabla MyValue sadrži vrijednost koju je korisnik unio ako korisnik klikne U redu ili pritisne tipku ENTER . Ako korisnik klikne Odustani, vraća se niz nulte duljine.
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)
