Parāda uzvedni dialoglodziņā, gaida, līdz lietotājs ievada tekstu vai noklikšķina uz pogas, un atgriež virkni ar tekstlodziņa saturu.
Sintakse
InputBox(uzvedne [, virsraksts ] [, noklusējums ] [, xpos ] [, ypos ] [, palīdzības fails ] [, konteksts ] )
Funkcijas InputBox sintaksei ir šādi argumenti:
| Arguments | Apraksts |
|---|---|
| uzvedne | Obligāts arguments. Virknes izteiksme, kas tiek parādīta dialoglodziņā kā ziņojums. Uzvednes maksimālais garums ir aptuveni 1024 rakstzīmes atkarībā no izmantoto rakstzīmju platuma. Ja uzvedne sastāv no vairākām rindām, tās var atdalīt, izmantojot rakstatgriezes rakstzīmi (Chr(13)), rindiņas padeves rakstzīmi (Chr(10)) vai rakstatgriezes–rindiņas padeves rakstzīmju kombināciju (Chr(13) & Chr(10)). |
| Nosaukums | Neobligāts arguments. Dialoglodziņa virsrakstjoslā parādīta virknes izteiksme. Ja nosaukums tiek izlaists, lietojumprogrammas nosaukums tiek ievietots virsrakstjoslā. |
| noklusējums | Neobligāts arguments. Virknes izteiksme, kas tekstlodziņā tiek rādīta kā noklusējuma atbilde, ja nav norādīta nekāda cita ievade. Ja noklusējuma teksts tiek izlaists, tekstlodziņš tiek parādīts tukšs. |
| XPO | Neobligāts arguments. Skaitliska izteiksme, kas tvipos norāda horizontālo attālumu no dialoglodziņa kreisās malas no ekrāna kreisās malas. Ja xpos ir izlaists, dialoglodziņš ir horizontāli centrēts. |
| ypos | Neobligāts arguments. Skaitliska izteiksme, kas tvipos norāda vertikālo attālumu no dialoglodziņa augšējās malas no ekrāna augšdaļas. Ja ypos ir izlaists, dialoglodziņš ir novietots vertikāli apmēram trešdaļu no ekrāna lejup ceļa. |
| palīdzības fails | Neobligāts arguments. Virknes izteiksme, kas identificē palīdzības failu, kas jāizmanto kontekstjutīgas palīdzības sniegšanai par dialoglodziņu. Ja tiek sniegts palīdzības fails , ir jānodrošina arī konteksts . |
| Konteksts | Neobligāts arguments. Skaitliska izteiksme, kas ir palīdzības konteksta numurs, ko palīdzības autors piešķīris attiecīgajai palīdzības tēmai. Ja ir sniegts konteksts , ir jānodrošina arī palīdzības fails . |
Piezīmes
Ja ir norādīts gan palīdzības fails , gan konteksts , lietotājs var nospiest taustiņu F1 (Windows) vai HELP (Macintosh), lai skatītu kontekstam atbilstošo palīdzības tēmu. Dažas resursdatora lietojumprogrammas arī automātiski pievieno dialoglodziņam pogu Palīdzība . Ja lietotājs noklikšķina uz Labi vai nospiež taustiņu ENTER, funkcija InputBox atgriež tekstlodziņā esošo saturu. Ja lietotājs noklikšķina uz Atcelt, funkcija atgriež nulles garuma virkni ("").
Piezīme
Lai norādītu vairāk nekā pirmo nosaukto argumentu, izteiksmē jāizmanto InputBox . Lai izlaistu dažus pozicionālus argumentus, ir jāiekļauj attiecīgais komatu atdalītājs.
Piemērs
Piezīme
Turpmākajos piemēros redzama šīs funkcijas izmantošana Visual Basic for Applications (VBA) modulī. Lai iegūtu papildinformāciju par darbu ar VBA, nolaižamajā sarakstā atlasiet Uzziņas materiāli izstrādātājiem blakus meklēšanas lodziņam un ievadiet šajā lodziņā vienu vai vairākus vārdus.
Šajā piemērā ir parādīti dažādi veidi, kā izmantot funkciju InputBox , lai prasītu lietotājam ievadīt vērtību. Ja x un y pozīcijas tiek izlaistas, dialoglodziņš tiek automātiski centrēts atbilstoši attiecīgajām asīm. Mainīgais MyValue satur vērtību, ko lietotājs ievada, ja lietotājs noklikšķina uz Labi vai nospiež taustiņu ENTER. Ja lietotājs noklikšķina uz Atcelt, tiek atgriezta nulles garuma virkne.
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)