Viser en ledetekst i en dialogboks, venter på at brukeren skal skrive inn tekst eller klikke en knapp, og returnerer en streng som inneholder innholdet i tekstboksen.
Syntaks
InputBox ( prompt [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
Syntaksen for funksjonen InputBox har følgende argumenter:
Argument |
Beskrivelse |
---|---|
Spørsmål |
Obligatorisk. Strenguttrykk vises som meldingen i dialogboksen. Maksimumslengden på ledeteksten er omtrent 1024 tegn, avhengig av bredden på tegnene som brukes. Hvis ledetekst består av mer enn én linje, kan du skille linjene ved hjelp av et vognreturtegn (Chr(13)), et linjefeedtegn (Chr(10)) eller kombinasjon av vognretur-linjefeed (Chr(13) & Chr(10)) mellom hver linje. |
title |
Valgfritt. Strenguttrykk som vises på tittellinjen i dialogboksen. Hvis du utelater tittel, plasseres programnavnet på tittellinjen. |
standard |
Valgfritt. Strenguttrykk vises i tekstboksen som standardsvar hvis ingen andre inndata er angitt. Hvis du utelater standard, vises tekstboksen tom. |
xpos |
Valgfritt. Numerisk uttrykk som angir, i twips, den vannrette avstanden til venstre kant av dialogboksen fra venstre kant av skjermen. Hvis xpos utelates, midtstilles dialogboksen vannrett. |
ypos |
Valgfritt. Numerisk uttrykk som angir, i twips, den loddrette avstanden til øvre kant av dialogboksen fra toppen av skjermen. Hvis ypos utelates, plasseres dialogboksen loddrett omtrent en tredjedel av veien nedover på skjermen. |
hjelpefil |
Valgfritt. Strenguttrykk som identifiserer hjelpefilen som skal brukes til å gi kontekstavhengig hjelp for dialogboksen. Hvis hjelpefilen er angitt, må kontekst også angis. |
Sammenheng |
Valgfritt. Numerisk uttrykk som er kontekstnummeret i Hjelp tilordnet til det aktuelle hjelpeemnet av hjelp-forfatteren. Hvis kontekst er angitt, må også hjelpefilen angis. |
Merknader
Når både hjelpefil og kontekst er angitt, kan brukeren trykke F1 (Windows) eller HJELP (Macintosh) for å vise hjelpeemnet som tilsvarer konteksten. Noen vertsprogram legger også automatisk til en Hjelp-knapp i dialogboksen. Hvis brukeren klikker OK eller trykker ENTER, returnerer InputBox-funksjonen det som er 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 en uttrykk. Hvis du vil utelate noen posisjonsargumenter, må du inkludere det tilsvarende semikolonskilletegnet.
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 ulike 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 angis av brukeren hvis brukeren klikker OK eller trykker ENTER-tasten. 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)