eventoCondizioni di notifica
Questo evento viene notificato dall'applicazione ogni volta che l'utente attiva un qualunque comando contenuto in un command set. Questo avviene quando:
- L'utente attiva un comando contenuto in un CommandSet visualizzato nella toolbar, mostrato come menu popup o visualizzato nella menu bar. In tutti questi casi l'evento sarà notificato all'applicazione.
Utilizzo consigliato
L'evento di GlobalCmdSetCommand può essere utilizzato per eseguire particolari procedure a seconda del comando selezionato dall'utente.
Uno dei possibili utilizzi è quello consentire la gestione dei comandi di un menu creato dinamicamente tramite il metodo AddCommandSet di applicazione.
Argomenti
| Command Set | E' un'istanza di tipo IDCommand che rappresenta il comand set che contiene il comando utilizzato dall'utente. |
| Command | E' un'istanza di tipo IDCommand che rappresenta il comand utilizzato dall'utente. |
| Cancel | Se valorizzato a True indica al sistema che non deve notificare gli eventi specifici dei command set qualora implementati. |
Esempio di codice
// ****************************************************************
// Event raised by the application when the user uses one commands.
// ****************************************************************
event NewWebApplication.GlobalCmdSetCommand(
IDCommand CommandSet // Command set that contains the used command
IDCommand Command // Command used by the user
inout boolean Cancel // If set to True the system does not raise the specific command set events if implemented
)
{
switch (CommandSet.code())
{
case "ORDERS":
switch (Command.code())
{
case "NEWORDER":
// Handle command
break
}
break
}
}
// Event raised by the application when the user uses one commands.
// ****************************************************************
event NewWebApplication.GlobalCmdSetCommand(
IDCommand CommandSet // Command set that contains the used command
IDCommand Command // Command used by the user
inout boolean Cancel // If set to True the system does not raise the specific command set events if implemented
)
{
switch (CommandSet.code())
{
case "ORDERS":
switch (Command.code())
{
case "NEWORDER":
// Handle command
break
}
break
}
}
- Questo evento può essere utilizzato per centralizzare la gestione dei comandi di tutto il menù dell'applicazione. Il sistema, infatti, notifica l'evento quando l'utente utilizza un qualunque comando.
- E' necessario implementare questo evento qualora si crei dinamicamente il menù tramite il metodo AddCommandSet. In quel caso, infatti, dato che il command set non era presente a design-time non è possibile implementare l'evento OnCommand dello stesso e occorre implementare questo evento per gestire i vari comandi.
Ultima modifica: 13/12/2019 / Validità: da 19.5.7600