Scopo
Mostra un messaggio relativo a questo pannello nella barra dei messaggi.
Sintassi
Pannello.SetInfoMessage(tipo messaggio, testo messaggio, priorità)
Argomenti
tipo messaggio | E' un numero intero che rappresenta il tipo di messaggio. Occorre utilizzare uno dei valori della lista valori MessageTypes (INFO per messaggio informativo, WARN per messaggio di avviso, ERROR per messaggio di errore) |
testo messaggio | E' la stringa che verrà mostrata come testo del messaggio |
priorità | E' un parametro opzionale intero che rappresenta la priorità del messaggio. Se una funzione Visual Code chiama più volte questa procedura sullo stesso pannello, allora verrà mostrato il messaggio con la priorità più alta. Il valore di default è 2, maggiore dei messaggi di sistema che hanno priorità 1. |
Esempio di codice
// *********************************************************************
// Fired when in a multi-page layout, the panel changes the active page.
// *********************************************************************
event Ordini.Ordini.OnChangePage(
int NewPage // Nuova Pagina
inout boolean Cancel // Imposta a True per impedire il cambio pagina
)
{
// Se la pagina attuale è quella del destinatario...
if Ordini.Page = Ordini.Destinatario.Me()
{
// Se ho indicato il destinatario ma non il corriere...
if NOT(IsNull(Ordini.DestinatarioOrdine)) AND IsNull(Ordini.CorriereOrdine)
{
// Allora non posso cambiare pagina.
// P.S. questo vale anche per gli ordini già presenti nel DB.
Cancel := True
//
// Mostro il messaggio all'utente
Ordini.SetInfoMessage(ERROR, MSG Indicare Corriere, ??)
}
}
}
// Fired when in a multi-page layout, the panel changes the active page.
// *********************************************************************
event Ordini.Ordini.OnChangePage(
int NewPage // Nuova Pagina
inout boolean Cancel // Imposta a True per impedire il cambio pagina
)
{
// Se la pagina attuale è quella del destinatario...
if Ordini.Page = Ordini.Destinatario.Me()
{
// Se ho indicato il destinatario ma non il corriere...
if NOT(IsNull(Ordini.DestinatarioOrdine)) AND IsNull(Ordini.CorriereOrdine)
{
// Allora non posso cambiare pagina.
// P.S. questo vale anche per gli ordini già presenti nel DB.
Cancel := True
//
// Mostro il messaggio all'utente
Ordini.SetInfoMessage(ERROR, MSG Indicare Corriere, ??)
}
}
}
- Non è necessario cancellare esplicitamente il messaggio in quanto viene mostrato nel browser una sola volta e poi cancellato automaticamente alla prossima richiesta.
- Se, dopo aver impostato il messaggio è necessario cancellarlo prima che lo veda l'utente, è possibile chiamare la procedura con testo = empty string.
- Questa funzione non deve essere usata per mostrare un messaggio di errore o di avvertimento relativo ad un campo del pannello. In questo caso infatti è meglio utilizzare le funzioni SetErrorText e SetWarningText della libreria dei campi di pannello.
Ultima modifica: 05/04/2022 / Validità: da 6.5.2680