English
Instant Developer Foundation Documentazione
  • Reference Librerie
  • Libreria Client
  • Libreria Standard
  • Client Specific

Input Box

funzione copia link

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)

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
    }
  }
}
  • 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

Vedi Anche

  • Stringhe
  • Null Value (funzione)
  • RD3: Possibilità di assegnare una classe CSS per personalizzare stile e titolo delle MessageBox

Hai trovato utile l'articolo?

Grazie per il feedback!

Ti serve altro aiuto?

Consulta il Forum