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

Definition

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.Core.dll

Quelle:

Interaction.vb

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 aus mehr als einer Zeile 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. 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

String

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

In diesem Beispiel werden verschiedene Möglichkeiten zum Verwenden der InputBox Funktion gezeigt, 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 Kommatrennzeichen beibehalten.

Hinweis

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

Weitere Informationen

• MsgBox(Object, MsgBoxStyle, Object)
• Chr(Int32)
• ChrW(Int32)