Scopo
Richiede all'utente di digitare un testo e ritorna la risposta.
Può essere utilizzato per chiedere un valore all'utente senza creare un'apposita form.
Sintassi
string s = "" //
//
s := InputBox(domanda all'utente, testo predefinito)
//
s := InputBox(domanda all'utente, testo predefinito)
Argomenti
Message | È una stringa contenente il messaggio da mostrare all'utente. Può essere utilizzata per fare una domanda diretta o per spiegare il motivo della richiesta. |
Defualt Value | E' una stringa opzionale che permette di specificare un valore predefinito |
Valore di ritorno
Viene ritornata una stringa contenente la risposta digitata dall'utente. Nel caso in cui l'utente non scrive niente viene ritornata una stringa vuota.
Esempio
// *********************************************************
// Explain which processing is carried out by this procedure
// *********************************************************
public void HelloYou.Benvenuto()
{
Utente.Nome := Non specificato
//
Chiedi nome all'utente
{
string nome = "" // Il nome dell'utente connesso
//
// Se l'utente specifica un nome lo inserisco nella tabella IMDB
nome := InputBox(Inserisci il tuo nome:)
if NullValue(nome, Empty String) <> Empty String
{
Utente.Nome := nome
}
}
}
// Explain which processing is carried out by this procedure
// *********************************************************
public void HelloYou.Benvenuto()
{
Utente.Nome := Non specificato
//
Chiedi nome all'utente
{
string nome = "" // Il nome dell'utente connesso
//
// Se l'utente specifica un nome lo inserisco nella tabella IMDB
nome := InputBox(Inserisci il tuo nome:)
if NullValue(nome, Empty String) <> Empty String
{
Utente.Nome := nome
}
}
}
- La funzione causa una duplice chiamata della procedura in cui viene utilizzata. La prima volta ritorna empty string e fa proseguire la procedura in cui viene utilizzata. Non appena viene chiuso il prompt da parte dell'utente la procedura viene fatta partire nuovamente, questa volta la funzione ritorna la risposta dell'utente o empty string se nessuna risposta è stata data.
-
In RD3, per poter mostrare del testo su più righe sarebbe necessario utilizzare il tag HTML
</br>
, ma per facilitare la portabilità delle applicazione da RD3 il sistema sostituisce automaticamente i \n con il tag HTML. - Dalla versione 16.0 è possibile configurare la classe CSS assegnata alla InputBox, in modo da poterne personalizzare la visualizzazione (nota di rilascio).
- Dalla versione 22.5 è possibile specificare un valore predefinito del campo di input (parametro Default Value).
Ultima modifica: 27/07/2022 / Validità: da 9.0.3940