Condizioni di notifica
Questo evento viene notificato da uno span quando l'utente ne modifica il valore, qualora lo span sia scrivibile, cioè ne sia stata attivata la proprietà Enabled.
Utilizzo consigliato
L'evento di OnChanging può essere utilizzato per intercettare la modifica al valore di uno span in un book scrivibile e aggiornare le tabelle del database.
La modifica al testo contenuto nello span può essere impedita impostando il parametro Cancel a True, ad esempio perchè in certe condizioni non è permesso modificare lo span.
Argomenti
Vecchio Valore | E' una stringa che fornisce il vecchio valore che aveva lo span prima della modifica |
Nuovo Valore | E' una stringa che fornisce il nuovo valore dello span dopo la modifica da parte dell'utente |
Cancel | E' un parametro booleano di input/output che può essere impostato a True per evitare che avvenga il cambio di valore. |
Esempio di codice
// *****************************************
// Fired when the span is changing its value
// *****************************************
event ImpiegatiBookMod.ImpiegatiBook.ReportImp.CognomeImpiegati.OnChanging(
string OldValue // What is this parameter for?
string NewValue // What is this parameter for?
inout boolean Cancel // What is this parameter for?
)
{
int ID = 0 // Brief description of field content.
//
// Recupero l'ID del record corrente
ID := ImpiegatiBook.IdimpiegatoImpiegati
//
// Aggiorno il valore del cognome
update Impiegati
set Cognome := NewValue
set ModificatoCognome := True
where
Idimpiegato = ID
//
// Ora il book è modificato
Parametri.BookModificato := True
}
// Fired when the span is changing its value
// *****************************************
event ImpiegatiBookMod.ImpiegatiBook.ReportImp.CognomeImpiegati.OnChanging(
string OldValue // What is this parameter for?
string NewValue // What is this parameter for?
inout boolean Cancel // What is this parameter for?
)
{
int ID = 0 // Brief description of field content.
//
// Recupero l'ID del record corrente
ID := ImpiegatiBook.IdimpiegatoImpiegati
//
// Aggiorno il valore del cognome
update Impiegati
set Cognome := NewValue
set ModificatoCognome := True
where
Idimpiegato = ID
//
// Ora il book è modificato
Parametri.BookModificato := True
}
- Attenzione: Se all'interno dell'evento di OnChanging viene chiamato il metodo Refresh del book (e quindi il book viene distrutto e ristampato) il sistema non notifica più l'evento per tutti gli altri span eventualmente modificati all'interno della stessa richiesta. In questo caso verrebbe notificata solo la modifica al primo span e verrebbero perse le modifiche agli altri span.
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680