Dialogo lange rodomas raginimas, laukiama, kol vartotojas įves tekstą arba spustelės mygtuką, ir grąžina eilutę su teksto lauko turiniu.
Sintaksė
InputBox(raginimas [, pavadinimas ] [, numatytasis ] [, xpos ] [, ypos ] [, žinyno failas ] [, kontekstas ] )
Funkcijos InputBox sintaksė turi tokius argumentus:
| Argumentas | Aprašymas |
|---|---|
| raginimas | Būtinas. Eilutės išraiška, rodoma kaip pranešimas dialogo lange. Maksimalus raginimo ilgis yra maždaug 1024 simboliai, atsižvelgiant į naudojamų simbolių plotį. Jei raginimą sudaro daugiau nei viena eilutė, tarp eilučių galite atskirti eilutes naudodami eilutės grįžimo simbolį (Chr(13)), eilutės grąžinimo simbolį (Chr(10)) arba eilutės grįžimo/eilutės pristatymo simbolių derinį (Chr(13) & Chr(10)). |
| pavadinimas | Pasirinktinis. Eilutės išraiška, rodoma dialogo lango pavadinimo juostoje. Jei praleisite pavadinimą, programos pavadinimas bus įtrauktas į pavadinimo juostą. |
| numatytoji reikšmė | Pasirinktinis. Eilutės išraiška, teksto lauke rodoma kaip numatytasis atsakymas, jei nepateikiama jokia kita įvestis. Jei nenurodysite numatytųjų parametrų, teksto laukas bus rodomas tuščias. |
| XPOS | Pasirinktinis. Skaitinis reiškinys, tvipais nurodantis horizontalų atstumą nuo kairiojo dialogo lango krašto nuo kairiojo ekrano krašto. Jei xpos nenurodytas, dialogo langas yra horizontaliai centruojamas. |
| ypos | Pasirinktinis. Skaitinis reiškinys, tvipais nurodantis vertikalų atstumą nuo viršutinio dialogo lango krašto nuo ekrano viršaus. Jei funkcija "ypos " nenurodyta, dialogo langas yra vertikaliai išdėstytas maždaug trečdalį ekrano apačios. |
| žinyno failas | Pasirinktinis. Eilutės išraiška, identifikuojanti žinyno failą, naudotiną teikiant kontekstinį dialogo lango žinyną. Jei pateiktas žinyno failas , turi būti pateiktas kontekstas . |
| Kontekstas | Pasirinktinis. Skaitinis reiškinys, kuris yra žinyno konteksto numeris, kurį žinyno autorius priskyrė atitinkamai žinyno temai. Jei pateikiamas kontekstas , taip pat turi būti pateiktas žinyno failas . |
Pastabos
Kai yra pateiktas žinyno failas ir kontekstas , vartotojas gali paspausti F1 ("Windows") arba HELP ("Macintosh"), kad peržiūrėtų kontekstą atitinkančią žinyno temą. Kai kurios pagrindinės taikomosios programos taip pat automatiškai įtraukia žinyno mygtuką į dialogo langą. Jei vartotojas spustelėja Gerai arba ENTER, funkcija InputBox grąžina viską, kas yra teksto lauke. Jei vartotojas spustelėja Atšaukti, funkcija grąžina nulinio ilgio eilutę ("").
Pastaba
Norėdami nurodyti daugiau nei pirmą įvardintą argumentą, reiškinyje turite naudoti InputBox . Norėdami praleisti kai kuriuos pozicinius argumentus, turite įtraukti atitinkamą kablelio skyriklį.
Pavyzdys
Pastaba
Pateiktuose pavyzdžiuose parodyta, kaip naudoti šią funkciją „Visual Basic for Applications“ (VBA) modulyje. Daugiau informacijos apie darbą su VBA rasite išplečiamajame sąraše pasirinkę Kūrėjų nuoroda (šalia Ieškos) ir ieškos lauke įvedę vieną ar daugiau sąlygų.
Šiame pavyzdyje pateikiami įvairūs būdai, kaip naudoti funkciją InputBox norint paraginti vartotoją įvesti reikšmę. Jei x ir y padėtys nenurodytos, dialogo langas automatiškai perkeliamas atitinkamų ašių centre. Kintamajame MyValue yra vartotojo įvesta vertė, jei vartotojas spustelėja Gerai arba paspaudžia klavišą ENTER . Jei vartotojas spustelėja Atšaukti, grąžinama nulinio ilgio eilutė.
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)