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 [, title ] [, default ] [, xpos ] [, ypos ] [, helpfile ] [, context ] )
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 della richiesta è di circa 1024 caratteri, a seconda della larghezza dei caratteri usati. Se il prompt è costituito da più righe, è possibile separarle utilizzando un carattere di ritorno a capo (Chr(13)), un carattere di avanzamento riga (Chr(10)) o una combinazione di caratteri di ritorno a capo-riga (Chr(13) & Chr(10)) tra ogni riga. |
| titolo | Facoltativo. Espressione stringa visualizzata sulla barra del titolo della finestra di dialogo. Se si omette il titolo, il nome dell'applicazione viene inserito nella barra del titolo. |
| impostazione predefinita | Facoltativo. Espressione stringa visualizzata nella casella di testo come risposta predefinita se non viene fornito altro input. Se si omette il valore predefinito, la casella di testo viene visualizzata 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 xpos viene omesso, la finestra di dialogo è 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 ypos viene omesso, la finestra di dialogo è posizionata verticalmente a circa un terzo dello schermo. |
| 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 viene fornito il file della guida , è necessario specificare anche il contesto . |
| contesto | Facoltativo. Espressione numerica che rappresenta il numero di contesto della Guida assegnato all'argomento della Guida appropriato dall'autore della Guida. Se viene fornito il contesto , è necessario specificare anche il file della guida . |
Osservazioni
Quando vengono forniti sia il file della Guida che il contesto , l'utente può premere F1 (Windows) o HELP (Macintosh) per visualizzare l'argomento della Guida corrispondente al contesto. Alcune applicazioni host aggiungono automaticamente anche un pulsante Guida alla 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ù del primo argomento citato, è 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 inserito 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)