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

Definition

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Zeigt eine Eingabeaufforderung in einem Dialogfeld an, wartet, bis der Benutzer Text eingibt oder auf eine Schaltfläche klickt, und gibt dann eine Zeichenfolge zurück, die den Inhalt des Textfelds enthält.

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

Parameter

Prompt
String

Erforderlicher String Ausdruck, der als Meldung im Dialogfeld angezeigt wird. Die maximale Länge beträgt Prompt ca. 1024 Zeichen, je nach Breite der verwendeten Zeichen. Wenn Prompt sie aus mehreren Zeilen besteht, können Sie die Zeilen mit einem Wagenrücklaufzeichen (Chr(13)), einem Zeilenvorschubzeichen (Chr(10)) oder einer Wagenrücklauf-/Zeilenvorschubkombination (Chr(13) & Chr(10)) zwischen jeder Zeile trennen.

Title
String

Dies ist optional. String Ausdruck, der in der Titelleiste des Dialogfelds angezeigt wird. Wenn Sie weglassen Title, wird der Anwendungsname in der Titelleiste platziert.

DefaultResponse
String

Dies ist optional. String Ausdruck, der im Textfeld als Standardantwort angezeigt wird, wenn keine andere Eingabe bereitgestellt wird. Wenn Sie weglassen DefaultResponse, ist das angezeigte Textfeld leer.

XPos
Int32

Dies ist optional. Numerischer Ausdruck, der in Twips den Abstand des linken Rands des Dialogfelds vom linken Rand des Bildschirms angibt. Wenn Sie weglassen XPos, wird das Dialogfeld horizontal zentriert.

YPos
Int32

Dies ist optional. Numerischer Ausdruck, der in Twips den Abstand des oberen Rands des Dialogfelds vom oberen Rand des Bildschirms angibt. Wenn Sie weglassen YPos, wird das Dialogfeld vertikal ungefähr ein Drittel des Bildschirms nach unten positioniert.

Gibt zurück

String

Zeigt eine Eingabeaufforderung in einem Dialogfeld an, wartet, bis der Benutzer Text eingibt oder auf eine Schaltfläche klickt, und gibt dann eine Zeichenfolge zurück, die den Inhalt des Textfelds enthält.

Beispiele

Dieses Beispiel zeigt verschiedene Möglichkeiten zum Verwenden der InputBox Funktion, um den Benutzer aufzufordern, einen Wert einzugeben. Wenn die X- und Y-Positionen nicht angegeben werden, wird das Dialogfeld automatisch für die jeweiligen Achsen zentriert. Die Variable MyValue enthält den vom Benutzer eingegebenen Wert, wenn der Benutzer auf "OK" klickt oder die EINGABETASTE drückt.

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

Hinweise

Wenn der Benutzer auf Abbrechen klickt, wird eine Zeichenfolge der Länge NULL zurückgegeben.

Um mehr als das erste Argument anzugeben, müssen Sie die InputBox Funktion in einem Ausdruck verwenden. Wenn Sie keine Positionsargumente angeben, müssen Sie das entsprechende Kommatrennzeichen beibehalten.

Note

Die InputBox Funktion erfordert UIPermission auf der SafeTopLevelWindows Ebene, die sich auf die Ausführung in teilweise vertrauenswürdigen Situationen auswirken kann. Weitere Informationen finden Sie unter Anfordern von Berechtigungen und UIPermission .

Gilt für:

Weitere Informationen