Parāda uzvedni dialoglodziņā, gaida, līdz lietotājs ievada tekstu vai noklikšķinās uz pogas, un atgriež virkni, kurā ir tekstlodziņa saturs.
Sintakse
InputBox ( uzvedne [, virsraksts ] [, noklusējums ] [, xpos ] [, ypos ] [, helpfile ] [, konteksts ] )
Funkcijas InputBox sintaksē ir šādi argumenti:
|
Arguments |
Apraksts |
|
uzvedne |
Obligāts arguments. Virknes izteiksme, kas parādīta kā ziņojums dialoglodziņā. Uzvednes maksimālais garums ir aptuveni 1024 rakstzīmes atkarībā no izmantoto rakstzīmju platuma. Ja uzvednē ir vairāk nekā viena rindiņa, rindiņas var atdalīt, izmantojot rakstatgriezes rakstzīmi (Chr(13)), rindiņas plūsmas rakstzīmi (Chr(10)) vai rakstatgriezes-rindiņu plūsmas rakstzīmju kombināciju (Chr(13) & Chr(10)) starp rindiņām. |
|
virsraksts |
Neobligāts arguments. Virknes izteiksme, kas parādīta dialoglodziņa virsrakstjoslā. Ja virsraksts tiek izlaists, lietojumprogrammas nosaukums tiek ievietots virsrakstjoslā. |
|
noklusējums |
Neobligāts arguments. Virknes izteiksme, kas redzama tekstlodziņā kā noklusējuma atbilde, ja nav nodrošināta cita ievade. Ja tiek izlaists noklusējums, tekstlodziņš tiek rādīts tukšs. |
|
xpos |
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 dialoglodziņa augšējās malas vertikālo attālumu no ekrāna augšdaļas. Ja ypos ir izlaists, dialoglodziņš tiek vertikāli pozicionēts apmēram vienu trešo daļu no ekrāna apakšas. |
|
helpfile |
Neobligāts arguments. Virknes izteiksme, kas identificē palīdzības failu, ko izmantot, lai dialoglodziņā sniegtu kontekstjutīgu palīdzību. Ja ir nodrošinātspalīdzībasfails , ir jānorāda arī konteksts. |
|
konteksts |
Neobligāts arguments. Skaitliska izteiksme, kas ir palīdzības konteksta numurs, kuru palīdzības autors ir piešķīris atbilstošai palīdzības tēmai. Ja ir sniegts konteksts, ir jānorāda arī palīdzībasfails. |
Piebildes
Ja ir nodrošināts gan palīdzībasfails, 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ži resursa lietojumprogramma, piemēram, Microsoft Office Excel 2007, automātiski pievienot dialoglodziņam pogu Palīdzība. Ja lietotājs noklikšķina uz Labi vai nospiež taustiņu ENTER, funkcija InputBox atgriež visu, kas ir tekstlodziņā. Ja lietotājs noklikšķina uz Atcelt, funkcija atgriež nulles garuma virkni ("").
Piezīme.: Lai norādītu vairāk nekā pirmo argumentu ar nosaukumu, ir jāizmanto InputBoxizteiksme. Lai izlaistu dažus pozicionālos argumentus, ir jāiekļauj atbilstošs komatatdalī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ā parādīti dažādi veidi, kā izmantot funkciju InputBox , lai lietotājam piedāvātu ievadīt vērtību. Ja x un y pozīcijas ir izlaistas, dialoglodziņš tiek automātiski centrēts attiecībā uz atbilstošajām asīm. Mainīgajā MyValue iekļauta lietotāja ievadītā vērtība, 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)
