Condizioni di notifica
Evento notificato dall'applicazione quando viene passato un comando via URL. Questo accade se:
- Nell'URL utilizzata per aprire l'applicazione è presente il parametro CMD.
- Quando l'utente scrive il codice del comando nel campo cmd: della testata dell'applicazione e preme invio.
Utilizzo consigliato
L'evento di OnCommand può essere utilizzato per controllare l'applicazione mediante un semplice link. E' possibile ad esempio decidere quale schermata verrà aperta all'avvio a seconda del comando passato.
Argomenti
Command | E' una stringa contenente il valore del parametro di URL di nome CMD |
Esempio di codice
// ***************************************************
// Fired when a CMD tag is present in the query string
// ***************************************************
event EsempiGL.OnCommand(
string Command // What is this parameter for?
)
{
string comando = "" // Leggo il comando dall'URL
//
comando := GetURLCommand()
//
// Se c'è almeno un comando
if comando <> Empty String
{
EsempiGL.UserName := Default User Name
EsempiGL.UserRole := Anonymous
//
// Modifico la caption dell'applicazione per dare il benvenuto all'utente
EsempiGL.MainCaption := Benvenuto nell'applicazione di esempio di
IN:DE
//
// Imposto la welcome url al sito di Pro Gamma, verrà mostrato ogni volta
// che non ci sono form aperte
EsempiGL.WelcomeURL := www.progamma.com
//
// Imposto il logoff Url al sito di Pro Gamma, verrà aperto alla chiusura
// dell'applicazione
EsempiGL.LogoffURL := www.progamma.com
//
// Se il comando è "PRODOTTI" apro il form prodotti
if comando = PRODOTTI
{
Prodotti.Show(??)
}
}
}
// Fired when a CMD tag is present in the query string
// ***************************************************
event EsempiGL.OnCommand(
string Command // What is this parameter for?
)
{
string comando = "" // Leggo il comando dall'URL
//
comando := GetURLCommand()
//
// Se c'è almeno un comando
if comando <> Empty String
{
EsempiGL.UserName := Default User Name
EsempiGL.UserRole := Anonymous
//
// Modifico la caption dell'applicazione per dare il benvenuto all'utente
EsempiGL.MainCaption := Benvenuto nell'applicazione di esempio di
IN:DE
//
// Imposto la welcome url al sito di Pro Gamma, verrà mostrato ogni volta
// che non ci sono form aperte
EsempiGL.WelcomeURL := www.progamma.com
//
// Imposto il logoff Url al sito di Pro Gamma, verrà aperto alla chiusura
// dell'applicazione
EsempiGL.LogoffURL := www.progamma.com
//
// Se il comando è "PRODOTTI" apro il form prodotti
if comando = PRODOTTI
{
Prodotti.Show(??)
}
}
}
- Il valore del parametro viene passato via URL formattato così:
[URL applicazione]?CMD=[comando]. - E' possibile specificare ulteriori parametri del comando aggiungendoli alla query string come nel seguente esempio:
[URL applicazione]?CMD=[comando]&PAR1=VALORE&PAR2=VALORE....
Il parametri del comando potranno essere recuperati con la funzione GetURLParam dell'applicazione. - Se si desidera che l'applicazione salti la pagina di login nel caso di comando sulla query string, è necessario impostare la proprietà UserRole dell'applicazione nell'evento di Initialize oppure nell'evento di OnCommand.
Ultima modifica: 10/10/2022 / Validità: da 6.5.2680