Funktsioon InputBox

NB! :  See artikkel on masintõlgitud, vaadake lahtiütlust. Selle artikli ingliskeelse versiooni leiate aadressilt (viiteks).

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)

Märkus. : Masintõlke lahtiütlus. Selle artikli tõlkis arvutisüsteem ilma inimese sekkumiseta. Microsoft pakub selliseid masintõlkeid, et inglise keelt mittekõnelevad kasutajad saaksid vaadata sisu Microsofti toodete, teenuste ja tehnoloogiate kohta. Kuna artikkel on masintõlgitud, võib see sisaldada sõnavara-, süntaksi- või grammatikavigu.

Täiendage oma oskusi
Tutvuge koolitusmaterjalidega
Kasutage uusi funktsioone enne teisi
Liituge Office Insideri programmiga

Kas sellest teabest oli abi?

Täname tagasiside eest!

Täname tagasiside eest! Tundub, et võiksime teid kokku viia ühega meie Office'i tugiagentidest, kes aitab teil probleemi lahendada.

×