eventoCondizioni di notifica
Questo evento viene notificato al documento quando si desidera conoscere il valore di una Named Property. Questo può avvenire se:
- Un pannello DO contiene una colonna calcolata. In questo caso la Named Property viene letta per ogni documento corrispondente ad una riga visibile del pannello.
- Se in una procedura Visual Code viene letto il valore di una Named Property tramite la funzione GetNamedPropertyValue.
Utilizzo consigliato
Questo evento deve essere gestito per restituire al chiamante il valore di una proprietà calcolata del documento.
Argomenti
| Property Name | E' il nome della proprietà calcolata di cui si vuole ottenere il valore |
| Property Value | E' un parametro di output in cui deve essere memorizzato il valore della proprietà calcolata |
Esempio di codice
// *********************************************************
// Fired when the framework want know a named property value
// *********************************************************
event Ordine.GetNamedPropertyValue(
string PropertyName //
inout string PropertyValue //
)
{
// La proprietà Numero Righe rappresenta il numero di righe dell'ordine
if Upper(PropertyName) = NUMERO RIGHE
{
PropertyValue := Convert(RigheOrdini.Count())
}
}
// Fired when the framework want know a named property value
// *********************************************************
event Ordine.GetNamedPropertyValue(
string PropertyName //
inout string PropertyValue //
)
{
// La proprietà Numero Righe rappresenta il numero di righe dell'ordine
if Upper(PropertyName) = NUMERO RIGHE
{
PropertyValue := Convert(RigheOrdini.Count())
}
}
- Se la proprietà calcolata non viene riconosciuta, è consigliabile non modificare il valore da restituire che, in questo modo, rimane NULL.
- Il parametro Property Value è definito come String, ma è consigliabile passare il tipo di dato specifico della proprietà senza effettuare la conversione in stringa. Per ottenere questo è possibile usare la funzione Convert.
- Se per il documento è attivo il framework di sincronizzazione, questo evento viene richiamato per le proprietà DO_DOMAIN e DO_DONTSYNC che permettono di ottenere il dominio di appartenenza del documento e di specificare quali proprietà non devono essere sincronizzate. Per maggiori informazioni si consiglia di leggere il paragrafo 5.11 della Guida all'utilizzo di Instant Developer.
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680