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 del prompt è di circa 1024 caratteri, a seconda della larghezza dei caratteri usati. Se prompt è costituito da più righe, è possibile separare le righe usando un carattere di ritorno a capo (Chr(13)), un carattere di linefeed (Chr(10)) o una combinazione di caratteri di ritorno a capo e di linefeed (Chr(13) & Chr(10)) tra ogni riga. |
| titolo | Facoltativo. Espressione stringa visualizzata sulla barra del titolo della finestra di dialogo. Se si omette 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 l'impostazione predefinita, 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 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 ypos viene omesso, la finestra di dialogo viene posizionata verticalmente circa un terzo della strada verso il basso nello 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 fileguida , 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 viene fornito contesto , deve essere fornito anche fileguida . |
Osservazioni
Quando vengono forniti sia fileguida che contesto , l'utente può premere F1 (Windows) o GUIDA (Macintosh) per visualizzare l'argomento della Guida corrispondente al contesto. Alcune applicazioni host aggiungono automaticamente un pulsante ? 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ù 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)