Rodomas raginimas dialogo lange, kai vartotojas laukia įvesties teksto arba spustelėkite mygtuką ir pateikia eilutę, kurioje yra teksto lauko turinys.
Sintaksė
InputBox ( raginimas [, pavadinimas ] [, numatytasis ] [, xpos ] [, ypos ] [, Helpfile ] [, kontekstas ] )
Funkcijos InputBox sintaksė turi tokius argumentus:
|
Argumentas |
Aprašas |
|
raginimas |
Būtinas. Eilutės išraiška rodoma kaip pranešimas dialogo lange. Maksimalus raginimo ilgis – maždaug 1024 simboliai, atsižvelgiant į naudojamų simbolių plotį. Jei raginimas susideda iš daugiau nei vienos eilutės, galite atskirti eilutes naudodami perkėlimo grįžimo simbolį (Chr(13)), linefeed simbolį (Chr(10)) arba grįžties deklaraciją – linefeed simbolių derinys (Chr(13) & Chr(10)) tarp kiekvienos linijos. |
|
pavadinimą |
Pasirenkama. Dialogo lango pavadinimo juostoje rodoma eilutės išraiška. Jei praleisite pavadinimą, taikomosios programos pavadinimas bus įdėtas į pavadinimo juostą. |
|
numatytasis |
Pasirenkama. Eilutės išraiška rodoma teksto lauke kaip numatytasis atsakymas, jei nėra kitų įvesčių. Jei praleisite numatytąjį parametrą, teksto laukas rodomas tuščias. |
|
xpos |
Pasirenkama. Skaitinis reiškinys, kuris nurodo, kad figūrinė, kairiajame dialogo lango krašte esantis horizontalus atstumas nuo kairiojo ekrano krašto. Jei xpos praleidžiamas, dialogo langas yra horizontaliai centruotas. |
|
ypos |
Pasirenkama. Skaitinis reiškinys, kuris nurodo, kad "twips" yra vertikalaus atstumo viršutiniame dialogo lango krašte nuo ekrano viršaus. Jei ypos praleidžiamas, dialogo langas bus vertikaliai išdėstytas maždaug trečdalis ekrano dalies. |
|
Helpfile |
Pasirenkama. Eilutės reiškinys, identifikuojantis žinyno failą, skirtą dialogo langui pateikti kontekstinį žinyną. Jei teikiama Helpfile , taip pat turi būti pateiktas kontekstas . |
|
kontekste |
Pasirenkama. Skaitinis reiškinys, kuris padeda autoriaus žinyno temą, priskirtą atitinkamam žinyno temai. Jei kontekstas pateikiamas, Helpfile taip pat turi būti pateiktas. |
Pastabos
Kai pateikiami ir Helpfile , ir kontekstas , vartotojas gali paspausti F1 ("Windows") arba žinynas ("Macintosh"), kad peržiūrėtumėte žinyno temą, atitinkančią kontekstą. Kai kurios valdančioji programa, pvz., Microsoft Office Excel 2007, taip pat automatiškai įtraukia žinyno mygtuką į dialogo langą. Jei vartotojas spusteli gerai arba presai ENTER, funkcija InputBox pateikia viską, kas yra teksto lauke. Jei vartotojas spusteli Atšaukti, funkcija pateikia nulinio ilgio eilutę ("").
Pastaba: Norėdami nustatyti daugiau nei pirmąjį įvardytąjį argumentą, išraiška turite naudoti InputBox . Norėdami nepateikti kai kurių Pozicinių argumentų, turite įtraukti atitinkamą kableliais 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ėčių nėra, dialogo langas automatiškai centruojamas atitinkamoms ašims. Kintamasis MyValue yra vartotojo įvesta reikšmė, jei vartotojas spusteli gerai arba paspaudžia klavišą ENTER. Jei vartotojas spusteli 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)
