Kuvab dialoogiboksis viiba, ootab, kuni kasutaja sisestab teksti või klõpsab nuppu, ja tagastab stringi, mis sisaldab tekstivälja sisu.
Süntaks
InputBox ( viip [, tiitel ] [, vaikesäte ] [, x-positsioon ] [, y-positsioon ] [, spikrifail ] [, kontekst ] )
Funktsiooni InputBox süntaksil on järgmised argumendid.
|
Argument |
Kirjeldus |
|
viip |
Nõutav. Dialoogiboksis teatena kuvatav stringavaldis. Argumendi viip suurim lubatud pikkus on umbes 1024 märki, olenevalt kasutatavate märkide laiusest. Kui viip koosneb rohkem kui ühest reast, saate ridu eraldada, kasutades iga rea vahel tagasijooksu märki (Chr(13)), reavahetuse märki (Chr(10)) või nende mõlema märgi kombinatsiooni (Chr(13) & Chr(10)). |
|
tiitel |
Valikuline. Dialoogiboksi tiitliribal kuvatav stringavaldis. Kui jätate argumendi tiitel ära, paigutatakse tiitliribale rakenduse nimi. |
|
vaikesäte |
Valikuline. Tekstiväljal vaikevastusena kuvatav stringiavaldis, kui ühtegi muud sisestust ei tehta. Kui jätate argumendi vaikesäte ära, kuvatakse tühi tekstiväli. |
|
x-asukoht |
Valikuline. Arvavaldis, mis määrab dialoogiboksi vasaku serva horisontaalse vahemaa tvippides ekraani vasakust servast. Kui x-positsioon ära jätta, keskjoondatakse dialoogiboks horisontaalselt. |
|
y-asukoht |
Valikuline. Arvavaldis, mis määrab dialoogiboksi ülaserva vertikaalse vahemaa tvippides ekraani ülaservast. Kui y-positsioon ära jätta, paigutatakse dialoogiboks vertikaalselt ligikaudu ühe kolmandiku kaugusele ekraani ülaservast. |
|
spikrifail |
Valikuline. Stringavaldis, mis määrab dialoogiboksile kontekstitundlikku teavet pakkuva spikrifaili. Kui spikrifail on sisestatud, peab sisestatud olema ka kontekst. |
|
kontekst |
Valikuline. Arvavaldis, mis on asjakohasele spikriteemale spikri autori poolt määratud spikri kontekstinumber. Kui kontekst on sisestatud, peab sisestatud olema ka spikrifail. |
Kommentaarid
Kui määratud on nii spikrifail kui ka kontekst, võib kasutaja kontekstile vastava spikriteema kuvamiseks vajutada klahvi F1 (Windowsis) või HELP (Macis). Mõni hostrakendus (nt Microsoft Office Excel 2007) lisab dialoogiboksi ka automaatselt nupu Spikker. Kui kasutaja klõpsab nuppu OK või vajutab sisestusklahvi ENTER, tagastab funktsioon InputBox tekstivälja sisu. Kui kasutaja klõpsab nuppu Loobu, tagastab funktsioon nullpikkusega stringi ("").
Märkus.: Kui soovite määrata rohkem kui ainult esimese nimelise argumendi, peate funktsiooni InputBox kasutama avaldises. Positsiooniargumentide väljajätmiseks peate kaasama neile vastava komaeraldaja.
Näide
Märkus.: Järgmised näited kujutavad selle funktsiooni kasutamist rakenduse Visual Basic for Applications (VBA) moodulis. Lisateabe saamiseks VBA-ga töötamise kohta valige välja Otsing kõrval kuvatavast ripploendist väärtus Tootearendusmaterjal ja sisestage otsinguväljale üks või mitu sõna.
Selles näites on ära toodud mitu võimalust, kuidas kasutada funktsiooni InputBox selleks, et paluda kasutajal sisestada väärtus. Kui x- ja y-positsioonid on ära jäetud, keskjoondatakse dialoogiboks vastavatel telgedel automaatselt. Muutuja MyValue sisaldab kasutaja sisestatud väärtust, kui kasutaja klõpsab nuppu OK või vajutab sisestusklahvi ENTER. Kui kasutaja klõpsab nuppu Loobu, tagastatakse nullpikkusega string.
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)
