Casella di immissione

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

Struttura

InputBox(messaggio[, titolo][, valore predefinito][, posizione x][, posizione y][, file di aiuto, contesto])

Parametri

prompt - Espressione stringa visualizzata come messaggio nella finestra di dialogo. La lunghezza massima del prompt è di circa 1024 caratteri, a seconda della larghezza dei caratteri utilizzati. Se il prompt è composto da più righe, è possibile separarle inserendo un carattere di ritorno a capo (Chr(13)), un carattere di avanzamento riga (Chr(10)) o una combinazione dei due caratteri (Chr(13) & Chr(10)) tra una riga e l'altra.

titolo - Espressione stringa visualizzata nella barra del titolo della finestra di dialogo. Se non si specifica il titolo, nella barra del titolo verrà visualizzato il nome dell'applicazione.

predefinito - Espressione stringa visualizzata nella casella di testo come risposta predefinita se non viene fornito alcun altro input. Se non si specifica alcun valore predefinito, la casella di testo viene visualizzata vuota.

xpos - Espressione numerica che specifica, in twip, la distanza orizzontale tra il bordo sinistro della finestra di dialogo e il bordo sinistro dello schermo. Se xpos viene omesso, la finestra di dialogo viene centrata orizzontalmente.

ypos - Espressione numerica che specifica, in twip, la distanza verticale tra il bordo superiore della finestra di dialogo e la parte superiore dello schermo. Se ypos viene omesso, la finestra di dialogo viene posizionata verticalmente a circa un terzo della lunghezza dello schermo.

helpfile - Espressione stringa che identifica il file della Guida da utilizzare per fornire la Guida contestuale relativa alla finestra di dialogo. Se viene specificato il file di aiuto, è necessario specificare anche il contesto.

contesto - Espressione numerica che identifica il numero di contesto della Guida assegnato dall'autore della Guida all'argomento corrispondente. Se viene fornito il contesto, è necessario fornire anche il file di aiuto.

Descrizione

Quando vengono specificati sia il file della guida che il contesto, nella finestra di dialogo viene automaticamente aggiunto un pulsante "Aiuto".

Se l'utente fa clic su OK o preme INVIO, la funzione InputBox restituisce il contenuto della casella di testo. Se l'utente fa clic su Annulla, la funzione restituisce una stringa di lunghezza zero ('').

Esempio

L'esempio seguente utilizza la funzione InputBox per visualizzare una finestra di immissione dati e assegnare la stringa alla variabile Input:

Dim Input

Input = InputBox("Inserisci il tuo nome")

MsgBox("Hai inserito: " & Input) |