Condividi tramite


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

Definizione

Visualizza una richiesta in una finestra di dialogo, attende che l'utente immetta il testo o faccia clic su un pulsante, quindi restituisce una stringa con 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

Obbligatorio. Espressione 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 restituito a capo (13), un carattere di feed di linee (Chr(10) o una combinazione di ritorno/riga a capo (Chr(Chr(13)) & Chr(10))) tra ogni riga.

Title
String

facoltativo. Espressione String visualizzata nella barra del titolo della finestra di dialogo. Se si omette Title, nella barra del titolo viene visualizzato il nome dell'applicazione.

DefaultResponse
String

facoltativo. Espressione String visualizzata nella casella di testo come risposta predefinita se non viene specificato altro input. Se si omette DefaultResponse, la casella di testo visualizzata è vuota.

XPos
Int32

facoltativo. 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 centrata in senso orizzontale.

YPos
Int32

facoltativo. Espressione numerica che specifica, in twip, la distanza del bordo superiore della finestra di dialogo dal bordo superiore dello schermo. Se si omette YPos, la finestra di dialogo viene collocata a circa un terzo dello schermo in senso verticale partendo dall'alto.

Restituisce

Visualizza una richiesta in una finestra di dialogo, attende che l'utente immetta il testo o faccia clic su un pulsante, quindi restituisce una stringa con il contenuto della casella di testo.

Esempio

In questo esempio vengono illustrati diversi 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 per i rispettivi assi. La variabile MyValue contiene il valore immesso dall'utente se l'utente fa clic su OK o preme il tasto 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 omette qualsiasi argomento posizionale, è necessario conservare il delimitatore di virgole corrispondente.

Nota

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

Si applica a

Vedi anche