evento ricorrenteCondizioni di notifica
Questo evento viene notificato dal pannello, una volta per ogni riga visibile a video, quando il contenuto del buffer video (la parte visibile del pannello) cambia. Ciò avviene tipicamente quando:
- Il pannello cambia stato.
- I dati presenti nel pannello vengono modificati dall'utente.
- La riga attiva del pannello cambia.
- L'utente scorre nel set di dati utilizzando i comandi di navigazione.
- ...
Utilizzo consigliato
L'evento di On Dynamic Properties è spesso utilizzato per impostare alcune proprietà dei campi del pannello cella per cella. Ad esempio è possibile cambiare lo stile visuale di una cella, modificarne il tooltip, renderla disabilitata o invisibile, in modo molto semplice.
Argomenti
L'evento non ha argomenti. I dati presenti nella riga attiva del pannello possono essere letti dalla tabella IMDB sottesa, e non è possibile modificarli all'interno di questo evento.Esempio di codice
// *****************************************************************
// Notificato quando il pannello prepara la visualizzazione dei dati
// *****************************************************************
event Prodotti.Prodotti.OnDynamicProperties()
{
// Evidenzio in rosso i prodotti sotto scorta
if Prodotti.Scorte < Prodotti.LivelloDiRiordino
{
Prodotti.NomeProdotto.SetVisualStyle(Rosso)
}
}
// Notificato quando il pannello prepara la visualizzazione dei dati
// *****************************************************************
event Prodotti.Prodotti.OnDynamicProperties()
{
// Evidenzio in rosso i prodotti sotto scorta
if Prodotti.Scorte < Prodotti.LivelloDiRiordino
{
Prodotti.NomeProdotto.SetVisualStyle(Rosso)
}
}
- Questo evento è ricorrente perché può essere lanciato diverse volte nell'ambito della risposta del server al browser, per garantire il perfetto aggiornamento delle proprietà visuali in tutti i casi di possibile variazione delle stesse. Per questo deve essere utilizzato in modalità stateless, e non dovrebbe contenere query o algoritmi complessi al suo interno.
- All'interno di questo evento è possibile utilizzare le procedure: SetVisible, SetEnabled, SetVisualStyle, e le proprietà Tooltip e Text dei Campi del Pannello riferendosi alla singola cella invece che all'intera colonna.
- Attenzione: per ragioni di sicurezza non è possibile abilitare una cella appartente ad una colonna disabilitata o rendere visibile una cella contenuta in una colonna invisibile. E' quindi necessario ragionare sempre disabilitando o nascondendo i campi.
- Non è necessario ripristinare le proprietà modificate delle celle, esse vengono gestite in automatico dal sistema. Questo tuttavia non è vero per i campi statici.
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680