Näyttää kehotteen valintaikkunassa, odottaa, että käyttäjä syöttää tekstin tai napsauttaa painiketta ja palauttaa tekstiruudun sisällön sisältävän merkkijonon.
Syntaksi
InputBox ( kehote [, otsikko ] [, oletus ] [, x-sij ] [, y-sij ] [, ohjetiedosto ] [, konteksti ] )
InputBox-funktion syntaksilla on seuraavat argumentit:
Argumentti |
Kuvaus |
---|---|
kehote |
Pakollinen. Valintaikkunan viestinä näytetty merkkijonolauseke. Kehotteen enimmäispituus on noin 1 024 merkkiä käytettyjen merkkien leveyden mukaan. Jos kehotteessa on useampi kuin yksi rivi, voit erottaa rivit rivinvaihtomerkillä (Chr(13)), rivinsiirtomerkillä (Chr(10)) tai rivinvaihdon ja rivinsiirron merkin yhdistelmällä (Chr(13) & Chr(10)) kunkin rivin välissä. |
otsikko |
Valinnainen. Valintaikkunan otsikkorivillä näytetty merkkijonolauseke. Jos otsikko puuttuu, sovelluksen nimi sijoitetaan otsikkoriville. |
oletus |
Valinnainen. Tekstiruudussa oletusvastauksena näytetty merkkijonolauseke, jos muuta syöttöä ei anneta. Jos oletus puuttuu, tekstiruutu näytetään tyhjänä. |
x-sij |
Valinnainen. Numeerinen lauseke, joka määrittää valintaikkunan vasemman reunan vaakasuuntaisen etäisyyden näytön vasemmasta reunasta (mittayksikkönä 0,1764 mm). Jos x-sij puuttuu, valintaikkuna keskitetään vaakasuunnassa. |
y-sij |
Valinnainen. Numeerinen lauseke, joka määrittää valintaikkunan yläreunan pystysuuntaisen etäisyyden näytön yläreunasta (mittayksikkönä 0,1764 mm). Jos y-sij puuttuu, valintaikkuna sijoitetaan pystysuunnassa noin yksi kolmasosa näytön yläosasta alaspäin. |
ohjetiedosto |
Valinnainen. Ohjetiedoston määrittävä merkkijonolauseke, joka antaa kontekstisidonnaisia ohjeita valintaikkunalle. Jos annetaan ohjetiedosto, on myös annettava konteksti. |
konteksti |
Valinnainen. Numeerinen lauseke on ohjeen tekijän asianmukaiselle ohjeaiheelle määrittämä kontekstiluku. Jos annetaan konteksti, on myös annettava ohjetiedosto. |
Huomautuksia
Kun sekä ohjetiedosto että konteksti on annettu, käyttäjä voi painaa F1 (Windows) tai HELP (Macintosh), jos hän haluaa tarkastella kontekstia vastaavaa ohjeaihetta. Jotkin isäntäsovellus myös lisäävät automaattisesti Ohje-painikkeen valintaikkunaan. Jos käyttäjä valitsee OK tai painaa ENTER-näppäintä, InputBox-funktio palauttaa sen, mitä tekstiruudussa on. Jos käyttäjä valitsee Peruuta, funktio palauttaa tyhjän merkkijonon ("").
Huomautus: Jos haluat määrittää enemmän kuin ensiksi nimetyn argumentin, sinun on käytettävä InputBox-funktiota lausekessa. Jos haluat jättää pois joitakin paikka-argumentteja, sinun on sisällytettävä vastaava pilkkuerotin.
Esimerkki
Huomautus: Seuraavissa esimerkeissä kerrotaan, kuinka tätä funktiota käytetään Visual Basic for Applications (VBA) -moduulissa. Jos haluat lisätietoja VBA:n käytöstä, valitse Sovelluskehittäjän opasHaku-kentän viereisestä luettelosta ja anna yksi tai useampi hakuehto hakukenttään.
Tässä esimerkissä esitellään erilaisia tapoja käyttää InputBox-funktiota kehottamaan käyttäjää kirjoittamaan arvon. Jos x- ja y-sijainnit jätetään pois, valintaikkuna keskitetään automaattisesti vastaavien akselien suhteen. Muuttuja MyValue sisältää käyttäjän kirjoittaman arvon, jos käyttäjä valitsee OK tai painaa ENTER-näppäintä. Jos käyttäjä valitsee Peruuta, tyhjä merkkijono palautetaan.
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)