Visar en ledtext i en dialogruta, väntar på användarens textinmatning eller knappklick och returnerar en sträng med textrutans innehåll.
Syntax
InputBox(prompt [, rubrik ] [, standard ] [, xpos ] [, ypos ] [, hjälpfil ] [, sammanhang ] )
InputBox-funktionens syntax har följande argument:
| Argument | Beskrivning |
|---|---|
| ledtext | Obligatoriskt. Ett stränguttryck som visas som meddelande i dialogrutan. Den maximala ledtextlängden är cirka 1 024 tecken, beroende på vilken teckenbredd som används. Om uppmaningen består av fler än en rad kan du avgränsa raderna med ett vagnreturtecken (Chr(13)), ett radmatningstecken (Chr(10)) eller en teckenkombination för vagnretur/radmatning (Chr(13) & Chr(10)) mellan varje rad. |
| rubrik | Valfritt. Stränguttryck som visas i dialogrutans namnlista. Om du utelämnar rubrik placeras programnamnet i namnlisten. |
| standard | Valfritt. Ett stränguttryck som visas som standardsvar i textrutan om annan inmatning saknas. Om du utelämnar standard visas textrutan tom. |
| xpos | Valfritt. Ett numeriskt uttryck som anger det vågräta avståndet från dialogrutans vänsterkant till skärmens vänsterkant i twip. Om xpos utelämnas centreras dialogrutan vågrät. |
| ypos | Valfritt. Ett numeriskt uttryck som anger det lodräta avståndet från dialogrutans överkant till skärmens överkant i twip. Om ypos utelämnas positioneras dialogrutan lodrätt cirka en tredjedel ned på skärmen. |
| hjälpfil | Valfritt. Ett stränguttryck som identifierar den hjälpfil som används för att erbjuda sammanhangsberoende hjälp för dialogrutan. Om hjälpfil anges måste du också ange kontext . |
| sammanhang | Valfritt. Ett numeriskt uttryck för det hjälpsammanhangsnummer som tilldelats hjälpavsnittet av hjälpavsnittets författare. Om kontext anges måste hjälpfil också tillhandahållas. |
Kommentarer
Om både hjälpfil och kontext har angetts kan användaren trycka på F1 (Windows) eller HJÄLP (Macintosh) för att visa hjälpavsnittet som motsvarar kontexten. En del värdprogram lägger också automatiskt till en hjälpknapp i dialogrutan. Om användaren klickar på OK eller trycker på Retur returnerar InputBox-funktionen det innehåll som finns i textrutan. Om användaren klickar på Avbryt retunerar funktionen en nollängdssträng ("").
Obs
Om du vill ange fler än det första namngivna argumentet måste du använda InputBox i ett uttryck. Om du vill utelämna vissa positionsargument måste du ta med motsvarande kommaavgränsade värden.
Exempel
Obs
I exemplen nedan visar vi hur du använder den här funktionen i en Visual Basic for Applications-modul (VBA). Om du vill läsa mer om hur man använder VBA, kan du välja Info för utvecklare i listrutan bredvid Sök och sedan skriva en eller flera söktermer i sökrutan.
Det här exemplet visar olika sätt som InputBox-funktionen kan användas för att uppmana användaren att ange ett värde. Om X- och Y-positioner utelämnas centreras dialogrutan automatiskt för de respektive axlarna. Variabeln MyValue innehåller det värde som användaren angett om användaren klickar på OK eller trycker på RETUR. Om användaren klickar på Avbryt returneras en nollängdssträng.
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)