Viser en melding i en dialogboks, venter på at brukeren skal skrive inn tekst eller skal klikke en knapp, og returnerer en streng som inneholder innholdet i tekstboksen.
Syntaks
InputBox(prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
Syntaksen for InputBox-funksjonen har disse argumentene:
| Argumenter | Beskrivelse |
|---|---|
| ledetekst | Obligatorisk. Strenguttrykk vist som meldingen i dialogboksen. Maksimal lengde på spørsmål er omtrent 1024 tegn, avhengig av bredden på tegnene som brukes. Hvis ledeteksten består av mer enn én linje, kan du skille linjene ved hjelp av et returtegn (Chr(13)), et linjeskifttegn (Chr(10)) eller en kombinasjon av returtegn–linjeskift (Chr(13) & Chr(10)) mellom hver linje. |
| Tittel | Valgfritt. Strenguttrykk vist i tittellinjen i dialogboksen. Hvis du utelater tittel, plasseres programnavnet på tittellinjen. |
| standard | Valgfritt. Strenguttrykk vist i tekstboksen som standardsvar hvis ingen andre inndata er angitt. Hvis du utelater standard, vises tekstboksen som tom. |
| XPOS | Valgfritt. Numerisk uttrykk som i twips angir den vannrette avstanden mellom venstre kant av dialogboksen og venstre kant på skjermen. Hvis xpos utelates, midtstilles dialogboksen vannrett. |
| ypos | Valgfritt. Numerisk uttrykk som i twips angir den loddrette avstanden til den øvre kanten av dialogboksen fra toppen av skjermen. Hvis ypos er utelatt, er dialogboksen plassert loddrett omtrent en tredjedel ned på skjermen. |
| hjelpefil | Valgfritt. Strenguttrykk som identifiserer hjelpefilen som skal brukes til å gi kontekstavhengig hjelp for dialogboksen. Hvis hjelpefil er angitt, må kontekst også oppgis. |
| kontekst | Valgfritt. Numerisk uttrykk som er kontekstnummeret i Hjelp som er tilordnet det aktuelle hjelpeemnet av Hjelp-forfatteren. Hvis kontekst er oppgitt, må hjelpefilen også angis. |
Merknader
Når både hjelpefil og kontekst er angitt, kan brukeren trykke F1 (Windows) eller HELP (Macintosh) for å vise Hjelp-emnet som samsvarer med konteksten. Enkelte vertsprogrammer legger også automatisk til en Hjelp-knapp i dialogboksen. Hvis brukeren klikker OK eller trykker ENTER, returnerer InputBox-funksjonen det som står i tekstboksen. Hvis brukeren klikker Avbryt, returnerer funksjonen en tom streng ("").
Obs!
Hvis du vil angi mer enn det første navngitte argumentet, må du bruke InputBox i et uttrykk. Hvis du vil utelate enkelte plasseringsargumenter, må du inkludere det tilsvarende kommaskilletegnet.
Eksempel
Obs!
I eksemplene nedenfor vises bruken av denne funksjonen i en VBA-modul (Visual Basic for Applications). Hvis du vil ha mer informasjon om hvordan du arbeider med VBA, velger du Utviklerreferanse fra rullegardinlisten ved siden av Søk og skriver inn ett eller flere søkeord i søkeboksen.
Dette eksemplet viser forskjellige måter å bruke InputBox-funksjonen på for å be brukeren om å angi en verdi. Hvis x- og y-posisjonene utelates, midtstilles dialogboksen automatisk for de respektive aksene. Variabelen MyValue inneholder verdien som brukeren har angitt hvis brukeren klikker OK eller trykker på ENTER. Hvis brukeren klikker Avbryt, returneres en tom streng.
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)