Condizioni di notifica
Questo evento viene notificato al documento al variare di una delle proprietà pubbliche dello stesso. L'evento può essere congelato, quindi non viene notificato durante le fasi di Load e se la proprietà FreezeEvents è True.
Utilizzo consigliato
Questo evento può essere utilizzato con finalità di debug, cioè per vedere quando una proprietà del documento cambia, oppure per aggiornare immediatamente lo stato del documento al variare di una delle sue proprietà. Questo possibile, è tuttavia preferibile utilizzare l'evento di OnEndTransaction a questo scopo.
Argomenti
Property Index | E' un numero intero che indica quale proprietà è cambiata. Utilizzare la funzione ToPropertyIndex per effettuare i confronti. |
Cancel | E' un parametro booleano di output. Se impostato a True impedisce la modifica della proprietà. |
Esempio di codice
// ************************************************************
// Fired when a property is changing. This event can be frozen.
// ************************************************************
event Impegno.OnChangingProperty(
int PropertyIndex // Specify which property is changing
inout boolean Cancel // Set to TRUE to avoid property modification
)
{
// Se cambia l'ID della giacenza... l'articolo non è più valido
if PropertyIndex = ToPropertyIndex(IDGiacenza)
{
Articolo := Null Object
}
}
// Fired when a property is changing. This event can be frozen.
// ************************************************************
event Impegno.OnChangingProperty(
int PropertyIndex // Specify which property is changing
inout boolean Cancel // Set to TRUE to avoid property modification
)
{
// Se cambia l'ID della giacenza... l'articolo non è più valido
if PropertyIndex = ToPropertyIndex(IDGiacenza)
{
Articolo := Null Object
}
}
- Questo evento deve essere utilizzato solo se si desidera che l'aggiornamento dello stato del documento avvenga sempre, anche al di fuori delle transazioni documentali. Quando possibile è preferibile l'utilizzo dell'evento OnEndTransaction che consente di analizzare lo stato finale del documento nel suo complesso, invece che osservarlo nella sua dinamica.
- Nell'esempio di codice seguente l'evento viene utilizzato per annullare il puntatore ad un documento collegato (Articolo) se un altro documento collegato (IDGiacenza) cambia.
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680