Freigeben über


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

Definition

Zeigt eine Eingabeaufforderung in einem Dialogfeld an, wartet auf die Eingabe eines Textes oder auf das Klicken auf eine Schaltfläche durch den Benutzer und gibt eine Zeichenfolge zurück, die den Inhalt des Textfelds angibt.

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

Erforderlich. Als Meldung im Dialogfeld angezeigter String-Ausdruck. Die maximale Länge von Prompt beträgt ungefähr 1024 Zeichen, abhängig von der Breite der verwendeten Zeichen. Wenn Prompt sie aus mehr als einer Zeile besteht, können Sie die Linien 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. Auf der Titelleiste des Dialogfelds angezeigter String-Ausdruck. Wenn Sie Title nicht angeben, wird der Anwendungsname auf der Titelleiste platziert.

DefaultResponse
String

Dies ist optional. String-Ausdruck, der im Textfeld standardmäßig angezeigt wird, wenn keine andere Eingabe erfolgt. Wenn Sie DefaultResponse nicht angeben, ist das angezeigte Textfeld leer.

XPos
Int32

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

YPos
Int32

Dies ist optional. Numerischer Ausdruck, der den Abstand des oberen Randes des Dialogfelds vom oberen Rand des Bildschirms in Twips angibt. Wenn Sie YPos nicht angeben, wird das Dialogfeld vertikal um etwa ein Drittel der Bildschirmhöhe nach unten verschoben.

Gibt zurück

Zeigt eine Eingabeaufforderung in einem Dialogfeld an, wartet auf die Eingabe eines Textes oder auf das Klicken auf eine Schaltfläche durch den Benutzer und gibt eine Zeichenfolge zurück, die den Inhalt des Textfelds angibt.

Beispiele

Dieses Beispiel zeigt verschiedene Möglichkeiten, die InputBox Funktion zu verwenden, um den Benutzer zur Eingabe eines Werts aufzufordern. Wenn die x- und y-Positionen weggelassen 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 Positionsargumente weglassen, müssen Sie das entsprechende Kommastrennzeichen beibehalten.

Hinweis

Die InputBox Funktion benötigt UIPermission auf der SafeTopLevelWindows Ebene, was sich auf ihre Ausführung in Teilweise vertrauenswürdigen Situationen auswirken kann. Weitere Informationen finden Sie unter Anfordern von Berechtigungen und UIPermission .

Gilt für:

Weitere Informationen