Condizioni di notifica
Un CommandSet possiede due diversi stati: aperto e chiuso. L'evento OnChangeExpand viene notificato sul CommandSet quando l'utente clicca su di esso per aprirlo o chiuderlo.
Utilizzo consigliato
L'evento di OnChangeExpand potrebbe essere utilizzato, per esempio, per evitare che un utente apra o chiuda determinati CommandSet. Per fare questo è sufficiente implementare l'evento e valorizzare a True il parametro Cancel per i CommandSet che non devono essere aperti o chiusi.
Argomenti
Expanded | E' un valore booleano che indice se il CommandSet è stato aperto (True) o chiuso (False). |
Cancel | E' un parametro di uscita booleano. Se viene impostato a True l'operazione di apertura/chiusura viene annullata. |
Esempio di codice
// ********************************************************************
// Evento notificato dal Command Set quando viene espanso o collassato.
// ********************************************************************
event EsempiMS.Altro.OnChangeExpand(
boolean Expanded // Indica se il Command Set è stato aperto (True) o...
inout boolean Cancel // Impostando a True questo parametro si annulla la...
)
{
// Aggiungo alla caption un più o un meno in base allo stato di espansione
Altro.Caption := Altro +c FormatMessage( (|1), If(Expanded, più, meno),
??, ??, ??, ??)
}
// Evento notificato dal Command Set quando viene espanso o collassato.
// ********************************************************************
event EsempiMS.Altro.OnChangeExpand(
boolean Expanded // Indica se il Command Set è stato aperto (True) o...
inout boolean Cancel // Impostando a True questo parametro si annulla la...
)
{
// Aggiungo alla caption un più o un meno in base allo stato di espansione
Altro.Caption := Altro +c FormatMessage( (|1), If(Expanded, più, meno),
??, ??, ??, ??)
}
- L'evento viene notificato sia se il CommandSet viene aperto o chiuso dall'utente mediante click su di esso, sia se viene cambiato il valore della proprietà Expanded da codice.
- Tutti i cambi dello stato di espansione dei CommandSet dovuti alla gestione dell'automatismo di auto-collapse (proprietà MenuAutoCollapse dell'applicazione) non causano la notifica dell'evento.
- Il parametro Cancel non è supportato dai temi Ionic, Bootstrap e BootstrapZen.
Ultima modifica: 21/03/2022 / Validità: da 8.1.3650