Scopo
Questa proprietà permette di leggere e scrivere il codice del Comando o del CommandSet; il codice è un identificatore univoco calcolato in automatico oppure deciso dall'utente.
Sintassi
string code = IDCommand.code
Quando letta
Viene ritornata una stringa che contiene il codice del Comando o del CommandSet.
Quando impostata
Assegna un codice al comando o commandset.
Esempio di codice
// ***************************************************
// Salva la configurazione del comando su tabella IMDB
// ***************************************************
public void GestioneComandi.SaveCommand(
IDCommand Cmd // Comando da salvare
IDCommand parentCMS // Comando padre del comando attuale
)
{
// Inserisco i dati del comando
insert values into Commands
set Code = Cmd.code()
set Index = Cmd.index()
set Enabled = Cmd.enabled
set Visible = Cmd.visible
set Tooltip = Cmd.tooltip
set Caption = Cmd.caption
set Icon = Cmd.icon
set IsToolbar = if(Cmd.isToolbar(), true, false)
set IsMenu = if(Cmd.isMenu(), true, false)
set Expanded = if(Cmd.getExpanded(), true, false)
set IsCMS = if(Cmd.commandsCount() > 0, true, false)
set Level = Cmd.level()
set Parent = if(parentCMS != null, parentCMS.code(), null)
//
// Adesso passo ai miei figli
for (int i = 0; i < Cmd.commandsCount(); i = i + 1)
{
this.SaveCommand(Cmd.getCommand(i), Cmd)
}
}
// Salva la configurazione del comando su tabella IMDB
// ***************************************************
public void GestioneComandi.SaveCommand(
IDCommand Cmd // Comando da salvare
IDCommand parentCMS // Comando padre del comando attuale
)
{
// Inserisco i dati del comando
insert values into Commands
set Code = Cmd.code()
set Index = Cmd.index()
set Enabled = Cmd.enabled
set Visible = Cmd.visible
set Tooltip = Cmd.tooltip
set Caption = Cmd.caption
set Icon = Cmd.icon
set IsToolbar = if(Cmd.isToolbar(), true, false)
set IsMenu = if(Cmd.isMenu(), true, false)
set Expanded = if(Cmd.getExpanded(), true, false)
set IsCMS = if(Cmd.commandsCount() > 0, true, false)
set Level = Cmd.level()
set Parent = if(parentCMS != null, parentCMS.code(), null)
//
// Adesso passo ai miei figli
for (int i = 0; i < Cmd.commandsCount(); i = i + 1)
{
this.SaveCommand(Cmd.getCommand(i), Cmd)
}
}
- Questa proprietà può essere utilizzata per identificare in maniera univoca il comando, ad esempio per salvarne le proprietà su database e configurarle.
- Questa proprietà non è da confondere con la proprietà CodiceComando, attualmente non mappata in libreria, che è la stringa che l’utente deve inserire nella query string (CMD=codice) oppure nella casella di testo Cmd: in alto a destra nell’intestazione dell’applicazione per attivare il comando senza doverlo cercare nel menù.
- Il codice viene calcolato in maniera univoca da Inde, ma proprio per questo motivo può cambiare, ad esempio se viene aggiunto un comando con un nome simile. Perciò si raccomanda di disabilitare la gestione automatica del codice se si vuole utilizzare questa proprietà per identificare il comando in una procedura di profilazione personalizzata.
- Questa proprietà può essere utilizzata se si si utilizzano le funzioni AddCommandSet o AddCommand per creare dinamicamente command set e comandi. In quel caso, infatti, la gestione del comando avviene negli OnCommand e GlobalCmdSetCommand dove è possibile utilizzare la proprietà Code per distinguere tra loro i comandi.
Ultima modifica: 28/10/2019 / Validità: da 10.0.4300