eventoCondizioni di notifica
Evento notificato dal book prima di eseguire il comando collegato ad uno dei bottoni presenti sulla toolbar di un book mostrato in anteprima in una applicazione web.
Utilizzo consigliato
L'evento di OnCommand può essere utilizzato per intercettare i comandi inviati al book e sostituirli od integrarli con proprie procedure.
Il comando notificato dall'evento può essere cancellato impostando il parametro Cancel, quindi è possibile utilizzare questo evento per verificare che ci siano tutte le condizioni per poter eseguire tale comando.
Argomenti
| Command | E' un numero intero che rappresenta il comando che sta per essere eseguito. Deve essere confrontato con uno dei valori della lista valori BookCommands. |
| Cancel | Può essere impostato a True per cancellare il comando. |
| User Operation | E' un valore booleano che vale True se l'evento è stato notificato perché l'utente ha cliccato un bottone della toolbar del book, False altrimenti. |
Esempio di codice
// ****************************************************************
// Evento notificato dal book prima di eseguire un comando di book.
// ****************************************************************
event Categorie.LibroCategorie.OnCommand(
int Command // E' un numero intero che rappresenta il comando ...
inout boolean Cancel // Può essere impostato a True per cancellare il c...
boolean UserOperation // E' un valore booleano che vale True se l'evento...
)
{
// Se il comando è di navigazione
if Command = Navigate
{
boolean Prev = 0 //
boolean Home = 0 //
//
// Guardo di quale sotto comando si tratta
Prev := Length(GetSetting(Form, prev-1.x)) > ZERO
Home := Length(GetSetting(Form, home-1.x)) > ZERO
//
// Impedisco di tornare indietro
if Prev OR Home
{
Cancel := True
}
}
}
// Evento notificato dal book prima di eseguire un comando di book.
// ****************************************************************
event Categorie.LibroCategorie.OnCommand(
int Command // E' un numero intero che rappresenta il comando ...
inout boolean Cancel // Può essere impostato a True per cancellare il c...
boolean UserOperation // E' un valore booleano che vale True se l'evento...
)
{
// Se il comando è di navigazione
if Command = Navigate
{
boolean Prev = 0 //
boolean Home = 0 //
//
// Guardo di quale sotto comando si tratta
Prev := Length(GetSetting(Form, prev-1.x)) > ZERO
Home := Length(GetSetting(Form, home-1.x)) > ZERO
//
// Impedisco di tornare indietro
if Prev OR Home
{
Cancel := True
}
}
}
- Attualmente l'evento viene notificato solo se l'utente clicca uno dei bottoni della toolbar del book, quindi il parametro UserOperation è sempre True.
Ultima modifica: 29/09/2021 / Validità: da 8.0.3560
