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 ] [, xpos ] [, ypos ] [, 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 rivinvaihto-rivinsiirtomerkin yhdistelmällä (Chr(13) & Chr(10)) kunkin rivin välissä. |
| otsikko | Valinnainen. Valintaikkunan otsikkorivillä näytetty merkkijonolauseke. Jos jätät otsikon pois, sovelluksen nimi tulee näkyviin otsikkoriville. |
| oletus | Valinnainen. Tekstiruudussa oletusvastauksena näytetty merkkijonolauseke, jos muuta syöttöä ei anneta. Jos jätät oletusasetuksen pois, tekstiruutu näkyy 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-funktio 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-funktio 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 ohjetiedosto annetaan, myös konteksti on annettava. |
| konteksti | Valinnainen. Numeerinen lauseke on ohjeen tekijän asianmukaiselle ohjeaiheelle määrittämä kontekstiluku. Jos konteksti annetaan, myös ohjetiedosto on annettava. |
Huomautuksia
Kun sekä ohjetiedosto että konteksti on annettu, käyttäjä voi tarkastella kontekstia vastaavaa ohjeaihetta painamalla F1 (Windows) tai OHJE (Macintosh). Jotkin isäntäsovellukset lisäävät Ohje-painikkeen valintaikkunaan automaattisesti. 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 ensimmäisen nimetyn argumentin, sinun on käytettävä lausekkeessa InputBox-funktiota . 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 syöttämän 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)