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

Definizione

Spazio dei nomi:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.dll

Visualizza una richiesta in una finestra di dialogo, attende che l'utente inserisca testo o faccia clic su un pulsante e quindi restituisca una stringa contenente il contenuto della casella di testo.

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

Parametri

Prompt
String

Espressione obbligatoria String visualizzata come messaggio nella finestra di dialogo. La lunghezza massima di Prompt è di circa 1024 caratteri, a seconda della larghezza dei caratteri utilizzati. Se Prompt è costituito da più righe, è possibile separare le righe usando un carattere di ritorno a capo (Chr(13)), un carattere di avanzamento riga (Chr(10)) o una combinazione di ritorno a capo/avanzamento riga (Chr(13) e Chr(10)) tra ogni riga.

Title
String

Optional. String espressione visualizzata nella barra del titolo della finestra di dialogo. Se si omette Title, il nome dell'applicazione viene inserito nella barra del titolo.

DefaultResponse
String

Optional. String espressione visualizzata nella casella di testo come risposta predefinita se non viene fornito alcun altro input. Se si omette DefaultResponse, la casella di testo visualizzata è vuota.

XPos
Int32

Optional. Espressione numerica che specifica, in twip, la distanza del bordo sinistro della finestra di dialogo dal bordo sinistro dello schermo. Se si omette XPos, la finestra di dialogo viene allineata al centro orizzontalmente.

YPos
Int32

Optional. Espressione numerica che specifica, in twip, la distanza del bordo superiore della finestra di dialogo dalla parte superiore dello schermo. Se si omette YPos, la finestra di dialogo viene posizionata verticalmente circa un terzo della strada verso il basso dello schermo.

Valori restituiti

String

Visualizza una richiesta in una finestra di dialogo, attende che l'utente inserisca testo o faccia clic su un pulsante e quindi restituisca una stringa contenente il contenuto della casella di testo.

Esempio

In questo esempio vengono illustrati vari modi per usare la InputBox funzione per richiedere all'utente di immettere un valore. Se le posizioni x e y vengono omesse, la finestra di dialogo viene centrata automaticamente rispetto ai relativi assi. La variabile MyValue contiene il valore immesso dall'utente se l'utente fa clic su OK o preme INVIO.

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

Commenti

Se l'utente fa clic su Annulla, viene restituita una stringa di lunghezza zero ("").

Per specificare più del primo argomento, è necessario usare la InputBox funzione in un'espressione. Se si omettono argomenti posizionali, è necessario conservare il delimitatore virgola corrispondente.

Note

La InputBox funzione richiede UIPermission a SafeTopLevelWindows livello, che può influire sull'esecuzione in situazioni di attendibilità parziale. Per altre informazioni, vedere Richiesta di autorizzazioni e UIPermission .

Si applica a

Vedi anche