Interaction.InputBox(String, String, String, Int32, Int32) Methode

Definitie

Geeft een prompt weer in een dialoogvenster, wacht totdat de gebruiker tekst invoert of op een knop klikt en retourneert vervolgens een tekenreeks met de inhoud van het tekstvak.

public static string InputBox(string Prompt, string Title = "", string DefaultResponse = "", int XPos = -1, int YPos = -1);
static member InputBox : string * string * string * int * int -> string
Public Function InputBox (Prompt As String, Optional Title As String = "", Optional DefaultResponse As String = "", Optional XPos As Integer = -1, Optional YPos As Integer = -1) As String

Parameters

Prompt
String

De vereiste String expressie wordt weergegeven als het bericht in het dialoogvenster. De maximale lengte is Prompt ongeveer 1024 tekens, afhankelijk van de breedte van de gebruikte tekens. Als Prompt deze bestaat uit meer dan één regel, kunt u de lijnen scheiden met behulp van een regelterugloopteken (Chr(13)), een regelinvoerteken (Chr(10)) of een combinatie van regelterugloop/regelinvoer (Chr(13) & Chr(10)) tussen elke regel.

Title
String

Optional. String expressie weergegeven in de titelbalk van het dialoogvenster. Als u weglaat Title, wordt de naam van de toepassing in de titelbalk geplaatst.

DefaultResponse
String

Optional. String expressie die wordt weergegeven in het tekstvak als het standaardantwoord als er geen andere invoer wordt opgegeven. Als u weglaat DefaultResponse, is het weergegeven tekstvak leeg.

XPos
Int32

Optional. Numerieke expressie die in twips de afstand aangeeft van de linkerrand van het dialoogvenster vanaf de linkerrand van het scherm. Als u weglaat XPos, wordt het dialoogvenster horizontaal gecentreerd.

YPos
Int32

Optional. Een numerieke expressie die, in twips, de afstand van de bovenrand van het dialoogvenster aangeeft boven aan het scherm. Als u weglaat YPos, wordt het dialoogvenster verticaal ongeveer een derde van de weg omlaag in het scherm geplaatst.

Retouren

Geeft een prompt weer in een dialoogvenster, wacht totdat de gebruiker tekst invoert of op een knop klikt en retourneert vervolgens een tekenreeks met de inhoud van het tekstvak.

Voorbeelden

In dit voorbeeld ziet u verschillende manieren om de InputBox functie te gebruiken om de gebruiker te vragen een waarde in te voeren. Als u de argumenten voor de x- en y-posities weglaat, wordt het dialoogvenster automatisch gecentreerd voor de desbetreffende assen. De variabele MyValue bevat de waarde die door de gebruiker is ingevoerd als de gebruiker op OK klikt of op enter drukt.

Dim message, title, defaultValue As String
Dim myValue As Object
' Set prompt.
message = "Enter a value between 1 and 3"
' Set title.
title = "InputBox Demo"
defaultValue = "1"   ' Set default value.

' Display message, title, and default value.
myValue = InputBox(message, title, defaultValue)
' If user has clicked Cancel, set myValue to defaultValue
If myValue Is "" Then myValue = defaultValue

' Display dialog box at position 100, 100.
myValue = InputBox(message, title, defaultValue, 100, 100)
' If user has clicked Cancel, set myValue to defaultValue
If myValue Is "" Then myValue = defaultValue

Opmerkingen

Als de gebruiker op Annuleren klikt, wordt er een tekenreeks met de lengte nul ("") geretourneerd.

Als u meer dan het eerste argument wilt opgeven, moet u de InputBox functie in een expressie gebruiken. Als u positionele argumenten weglaat, moet u het bijbehorende scheidingsteken voor komma's behouden.

Note

De InputBox functie vereist UIPermission op het SafeTopLevelWindows niveau, wat van invloed kan zijn op de uitvoering ervan in gedeeltelijke vertrouwenssituaties. Zie Machtigingen aanvragen en UIPermission voor meer informatie.

Van toepassing op

Zie ook