Toolbar Event Type

Scopo

Indica come deve essere gestito l'evento di attivazione dei pulsanti della toolbar del pannello. Il valore predefinito della proprietà è Attivo ovvero il comando viene gestito dal browser e poi viene inviato immediatamente al server che ne completa l'esecuzione. Puoi fare riferimento alla lista valori EventTypes per ulteriori informazioni riguardo ai vari tipi di gestione disponibili.

Attualmente il client è in grado di eseguire in autonomia le seguenti operazioni:

• Lock: il pannello viene bloccato e tutti i campi vengono resi non scrivibili;
• Unlock: il pannello viene sbloccato ed i campi modificabili vengono resi scrivibili. Lo stato di "campo modificabile" è quello conosciuto al momento sul client e non è detto che corrisponda a quello che verrà poi comunicato dal server;
• Form List: il layout del pannello viene cambiato sul client;
• Top, Bottom, Next Page, Prev Page: lo scrolling avviene nel browser. Se alcuni dati non siano presenti nella cache dello stesso, essi verranno inviati dal server non appena quest'ultimo viene informato del comando.

Può essere utile modificare il tipo di gestione dell'evento di click sulla toolbar del pannello se l'applicazione gestisce eventi di pannello in modo da collidere con il comportamento automatico del browser.

Ad esempio se è stato gestito l'evento OnCommand per impedire il cambio di layout o è stato gestito l'evento OnChangeLocking per annullare che lo sblocco del pannello potrebbe essere utile assegnare alla proprietà ToolbarEventType il valore Server + Immediato. Qualora questo non venga fatto, infatti, si potrebbe presentare la seguente situazione:

1. l'utente clicca sul lucchetto per sbloccare il pannello. Il client non sa che l'operazione non è permessa e sblocca subito il pannello rendendo scrivibili i campi modificabili.
2. il browser invia un messaggio al server per indicare che il pannello è stato sbloccato. Il server riceve l'evento e scopre, notificando l'evento OnChangeLocking, che il pannello non può essere sbloccato. Quindi il server risponde al client indicando che il pannello è bloccato.
3. Il client blocca nuovamente il pannello.

Il tutto avviene in pochi istanti ma l'effetto è che il pannello si sblocca e riblocca in maniera un po' strana.

Sintassi

Quando letta

Restituisce un numero intero corrispondente al tipo di gestione dell'evento di click sui bottoni della toolbar del pannello.

Quando impostata

Imposta il tipo di gestione dell'evento di click sui bottoni della toolbar del pannello.

Note

• La modifica del tipo di gestione deve essere fatta nell'evento Load della videata, altrimenti l'informazione non viene acquisita dal browser.