Visualizza un prompt in una finestra di dialogo, attende l'immissione di testo o il clic su un pulsante da parte dell'utente e restituisce una stringa con il contenuto della casella di testo.
Sintassi
InputBox ( prompt [, titolo ] [, impostazione predefinita ] [, posx ] [, posy ] [, fileguida ] [, contesto ] )
La sintassi della funzione InputBox ha gli argomenti seguenti:
|
Argomento |
Descrizione |
|
prompt |
Obbligatorio. Espressione stringa visualizzata come messaggio nella finestra di dialogo. La lunghezza massima di prompt è circa 1024 caratteri, a seconda della larghezza dei caratteri usati. Se prompt è composto da più righe, è possibile separare le righe con un carattere di ritorno a capo (Chr(13)), un carattere di avanzamento riga (Chr(10)) o una combinazione di caratteri di ritorno a capo e avanzamento riga (Chr(13) & Chr(10)) tra ogni riga. |
|
titolo |
Facoltativo. Espressione stringa visualizzata sulla barra del titolo della finestra di dialogo. Se si omette titolo, sulla barra del titolo viene visualizzato il nome dell'applicazione. |
|
impostazione predefinita |
Facoltativo. Espressione stringa visualizzata nella casella di testo come risposta predefinita se non viene fornito altro input. Se si omette impostazione predefinita, verrà visualizzata una casella di testo vuota. |
|
posx |
Facoltativo. Espressione numerica che specifica, in twip, la distanza orizzontale del bordo sinistro della finestra di dialogo dal bordo sinistro dello schermo. Se il valore di posx viene omesso, la finestra di dialogo viene centrata orizzontalmente. |
|
posy |
Facoltativo. Espressione numerica che specifica, in twip, la distanza verticale del bordo superiore della finestra di dialogo dal bordo superiore dello schermo. Se il valore di posy viene omesso, la finestra di dialogo viene posizionata verticalmente a circa un terzo dell'altezza dello schermo rispetto al bordo superiore. |
|
fileguida |
Facoltativo. Espressione stringa che identifica il file della Guida da usare per fornire la Guida sensibile al contesto per la finestra di dialogo. Se l'argomento fileguida viene fornito, deve essere fornito anche contesto. |
|
contesto |
Facoltativo. Espressione numerica che rappresenta il numero di contesto della Guida assegnato all'argomento della Guida appropriato dall'autore della Guida. Se l'argomento contesto viene fornito, deve essere fornito anche fileguida. |
Osservazioni
Quando vengono forniti entrambi gli argomenti fileguida e contesto, l'utente può premere F1 (Windows) o AIUTO (Macintosh) per visualizzare l'argomento della Guida corrispondente a contesto. In alcuni casi, in un'applicazione host, ad esempio Microsoft Office Excel 2007, viene anche aggiunto automaticamente un pulsante Guida nella finestra di dialogo. 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 ("").
Nota: Per specificare più argomenti denominati oltre al primo, è necessario usare InputBox in un'espressione. Per omettere alcuni argomenti posizionali, è necessario includere il delimitatore virgola corrispondente.
Esempio
Nota: Gli esempi seguenti illustrano l'uso di questa funzione in un modulo di Visual Basic, Applications Edition (VBA). Per altre informazioni sull'uso di VBA, selezionare Riferimenti per sviluppatori nell'elenco a discesa accanto a Cerca e immettere uno o più termini nella casella di ricerca.
Questo esempio mostra diversi modi per usare la funzione InputBox 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 il tasto INVIO. Se l'utente fa clic su Annulla, viene restituita una stringa di lunghezza zero ("").
Dim Message, Title, Default, MyValue
Message = "Enter a value between 1 and 3" ' Set prompt.
Title = "InputBox Demo" ' Set title.
Default = "1" ' Set default.
' Display message, title, and default value.
MyValue = InputBox(Message, Title, Default)
' Use Helpfile and context.
' The Help button is added automatically.
MyValue = InputBox(Message, Title,,,,"DEMO.HLP", 10)
' Display dialog box at position 100, 100.
MyValue = InputBox(Message, Title, Default, 100, 100)
