Dialogo lange rodomas raginimas, laukiama, kol vartotojas įves tekstą arba spustelės mygtuką, ir pateikia eilutę, kurioje yra teksto lauko turinys.
Sintaksė
InputBox ( prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
Funkcijos InputBox sintaksė turi tokius argumentus:
|
Argumentas |
Aprašas |
|---|---|
|
Raginti |
Būtinas. Eilutės išraiška, rodoma kaip pranešimas dialogo lange. Didžiausias raginimo ilgis yra maždaug 1024 simboliai, atsižvelgiant į naudojamų simbolių plotį. Jei raginimą sudaro daugiau nei viena eilutė, galite atskirti eilutes naudodami perkėlimo simbolį (Chr(13)), eilutės informacijos santraukos simbolį (Chr(10)) arba eilutės eilutės santraukų simbolių derinį (Chr(13) & Chr(10)) tarp kiekvienos eilutės. |
|
Pavadinimas |
Pasirinktinis. Eilutės reiškinys, rodomas dialogo lango pavadinimo juostoje. Jei praimsite pavadinimą, programos pavadinimas bus perkeltas į pavadinimo juostą. |
|
numatytoji reikšmė |
Pasirinktinis. Eilutės reiškinys, rodomas teksto lauke kaip numatytasis atsakymas, jei nepateikiama jokia kita įvestis. Jei praleiskite numatytąją reikšmę, teksto laukas bus rodomas tuščias. |
|
xpos |
Pasirinktinis. Skaitinis reiškinys, kuris tvipais nurodo horizontalų atstumą nuo kairiojo dialogo lango krašto nuo kairiojo ekrano krašto. Jei xpos praleistas, dialogo langas rodomas horizontaliai centre. |
|
ypos |
Pasirinktinis. Skaitinis reiškinys, kuris tvipais nurodo vertikalų atstumą nuo viršutinio dialogo lango krašto nuo ekrano viršaus. Jei ypos praleistas, dialogo langas yra vertikaliai išdėstyti maždaug trečdalį kelio ekranu žemyn. |
|
žinyno failas |
Pasirinktinis. Eilutės reiškinys, identifikuojantis žinyno failą, kuris bus naudojamas teikiant kontekstinį dialogo lango žinyną. Jei pateikiamas žinyno failas , taip pat turi būti pateiktas kontekstas . |
|
Kontekste |
Pasirinktinis. Skaitinė išraiška, kuri yra žinyno konteksto numeris, kurį žinyno autorius priskyrė atitinkamai žinyno temai. Jei pateikiamas kontekstas , taip pat turi būti pateiktas žinyno failas . |
Pastabos
Kai pateikiamas ir žinyno failas , ir kontekstas , vartotojas gali paspausti F1 (Windows) arba HELP (Macintosh), kad peržiūrėtų kontekstą atitinkančią žinyno temą. Kai kurios valdančioji programa taip pat automatiškai įtraukia mygtuką Žinynas į dialogo langą. Jei vartotojas spustelėja Gerai arba paspaudžia ENTER , funkcija InputBox grąžins viską, kas yra teksto lauke. Jei vartotojas spustelėja Atšaukti, funkcija pateikia nulinio ilgio eilutę ("").
Pastaba: Norėdami nurodyti daugiau nei pirmąjį įvardytąjį argumentą, išraiška turite naudoti Įvesties lauką . Jei norite praleisti kai kuriuos poziinius argumentus, turite įtraukti atitinkamą kablelį.
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 rodomi įvairūs būdai, kaip naudoti funkciją InputBox norint paraginti vartotoją įvesti reikšmę. Jei x ir y vietos praleistos, dialogo langas automatiškai centruojamas pagal atitinkamas ašis. Kintamųjų MyValue yra vartotojo įvesta reikšmė, 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)
