proceduraScopo
Questa funzione imposta un messaggio di avvertimento relativo al contenuto del campo e deve essere usata principalmente nel ciclo di validazione del pannello, nell'evento di OnUpdatingRow. Il campo che contiene il messaggio viene segnalato con una sottolineatura di colore blu, eventualmente aggiungendo una riga alla barra dei messaggi.
Sintassi
Pannello.Campo.SetWarningText(messaggio di avvertimento, conferma utente richiesta)
Argomenti
| Messaggio di avvertimento | E' il testo del messaggio di avvertimento. |
| Conferma utente richiesta | E' un parametro opzionale booleano (default=falso) che permette di richiedere una conferma esplicita del messaggio di avvertimento all'utente. Per confermare l'utente può premere il tasto F12, effettuare doppio click sulla riga, oppure premere il selettore di riga. |
Esempio di codice
// *******************************************************
// Called when a field in a row has been changed by a user
// *******************************************************
event Prodotti.Prodotti.OnUpdatingRow(
int Column // Column that has been changed.
boolean FieldModified //
boolean FieldWasModified //
boolean RowWasModified //
boolean Inserting // This parameter is TRUE if the row is a new row
inout boolean Cancel //
)
{
// Se sto validando il campo Nome Prodotto....
if Column = Prodotti.NomeProdotto.Me()
...
//
// Se la scorta è nulla, la inizializzo a 10 unità
if IsNull(Prodotti.Scorte)
{
Prodotti.Scorte := C10
}
//
// Se la scorta è minore di 10 emetto un warning
if Prodotti.Scorte < C10
{
Prodotti.Scorte.SetWarningText(MSG Scorta Bassa, False)
}
}
// Called when a field in a row has been changed by a user
// *******************************************************
event Prodotti.Prodotti.OnUpdatingRow(
int Column // Column that has been changed.
boolean FieldModified //
boolean FieldWasModified //
boolean RowWasModified //
boolean Inserting // This parameter is TRUE if the row is a new row
inout boolean Cancel //
)
{
// Se sto validando il campo Nome Prodotto....
if Column = Prodotti.NomeProdotto.Me()
...
//
// Se la scorta è nulla, la inizializzo a 10 unità
if IsNull(Prodotti.Scorte)
{
Prodotti.Scorte := C10
}
//
// Se la scorta è minore di 10 emetto un warning
if Prodotti.Scorte < C10
{
Prodotti.Scorte.SetWarningText(MSG Scorta Bassa, False)
}
}
- Questa procedura è pensata per essere utilizzata all'interno del ciclo di validazione del pannello (evento OnUpdatingRow). Utilizzandola in altri contesti potrebbe non funzionare come ci si aspetta.
- Il modo con cui il messaggio di avvertimento viene visualizzato dipende dai parametri di output dei messaggi di errore. Vedi anche SetErrorMode per maggiori informazioni.
- Non è necessario resettare il messaggio di avvertimento impostato sul campo perchè esso viene annullato dal framework all'inizio del ciclo di validazione del pannello.
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680