DEFTOOLBAR
Permette la definizione di una barra di comandi (toolbar) indipendentemente dal controllo di appartenenza.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| IDTOOLBAR | Stringa | ||||
| FOGLIODISTILE | Stringa | ||||
| TIPOTOOLBAR | Stringa | ||||
| TITOLO | |||||
| SEPARATORE | Stringa | ||||
| IMMAGINE | Stringa | ||||
| IDBOTTONE | Stringa | ||||
| AZIONE | |||||
| NASCOSTO | Condizione | ||||
| DISABILITATO | Condizione | ||||
| EVIDENZIATO | Condizione | ||||
| INVISIBILE | Intero | ||||
| CONVARIABILI | Intero | ||||
| VALIDAZIONE | Intero | ||||
| VALIDADATI | Enumerazione | ||||
| ACCELERATORE | Stringa | ||||
| COMMENTO | Variabile | ||||
| BOTTONE |
IDTOOLBAR
Consente di specificare l'identificatore mnemonico univoco della toolbar.
FOGLIODISTILE
Consente di specificare il file Foglio di stile.
TIPOTOOLBAR
Consente di specificare qual è il tipo della toolbar.
TITOLO
Definisce la posizione del pulsante. Indicando il parametro BARRATITOLO il pulsante sarà posizionato e sempre visibile sulla toolbar nella posizione indicata. Qualora sia indicato il parametro INDIETRO il pulsante verrà posizionato alla sinistra del titolo e identificato con l'icona ←
SEPARATORE
Indica che la voce è un separatore.
IMMAGINE
Specifica il nome del file contenente l'immagine o la risorsa immagine da visualizzare sul bottone. Se non specificato al bottone sarà assegnato una immagine 'standard'.
IDBOTTONE
Specifica l'identificatore mnemonico univoco della singolo bottone.
AZIONE
Permette di specificare l'azione che deve essere eseguita in conseguenza del click sul bottone.
NASCOSTO
Consente di nascondere il bottone.
Se non è presente il bottone risulta visibile.
DISABILITATO
Attributo di disabilitazione del bottone.
Il bottone disabilitato appare in 'grigetto' e non è possibile eseguire l'azione ad esso associato.
Se non è specificato, il bottone risulta abilitato.
EVIDENZIATO
Espressione che definisce la condizione per la quale il controllo deve risultare evidenziato. Quando evidenziato, nell'angolo altro destro viene visualizzato un triangolino colorato.
Il colore del triangolino varia a seconda del contest: rosso per desktop, giallo per web.
INVISIBILE
Attributo utilizzabile per rendere invisibile il pulsante senza però disabilitarlo. Ovvero, il pulsante, pur non essendo presente a video, è attivabile tramite tastiera.
Se omesso, pulsante è visibile ( in base alle condizioni definite per l'attributo NASCOSTO).
CONVARIABILI
La presenza del parametro istruisce il programma ad acquisire le variabili della videata prima di eseguire l'azione richiesta.
Consente, prima di eseguire l'azione associata al bottone, di produrre le decodifiche della videata e i relativi controlli di validità sui valori immessi, bloccando l'esecuzione dell'azione nel caso di errore.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
VALIDAZIONE
Attributo utilizzabile per indicare che il pulsante deve effettuare la validazione della videata prima di eseguire la propria azione.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
VALIDADATI
Indica il tipo di validazione da eseguire prima dell'azione.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
PROPRIETA | |
OGGETTO | |
NESSUNA | |
PROPRIETANORIGA |
ACCELERATORE
Definizione del tasto che, se premuto, ha lo stesso effetto del click sul bottone.
I tasti ammessi sono combinazioni di <Ctrl+Alt> oppure solo <Alt> e un carattere della tastiera; il formalismo prevede la notazione 'Ctrl-Alt+' oppure 'Alt+' seguita dal carattere scelto (es.: 'Ctrl+Alt+G', 'Alt+H'). I caratteri ammessi sono: lettere, numeri e i seguenti caratteri speciali '+-*/'.
*Alcune combinazioni di tasti sono state riservate per il richiamo rapido da tastiera delle funzionalità messe a disposizione dall’ambiente di sviluppo. *Dalla versione 26.1 del traduttore, il valore del parametro va indicato tra doppi apici.
COMMENTO
Definizione del tip multilinea di commento da associare al pulsante.
Il commento rimarrà visibile per il tempo in cui il mouse punterà sul pulsante interessato.
BOTTONE
Specifica l'identificatore mnemonico univoco del singolo bottone.
Esempi
Esempio utilizzo toolbar
'@DEFVID DIM[20,50] TIT["Videata"] TOOLBAR[IDTOOLBAR["ToolBar"]]
'@DEFTOOLBAR IDTOOLBAR["ToolBar"] _
BOTTONE[IDBOTTONE["SYS_EXIT"] TITOLO["Abbandona"] AZIONE[Abbandona()] ACCELERATORE["F1"]] _
BOTTONE[IDBOTTONE["SYS_SAVE"] TITOLO["Salva"] AZIONE[Salva()] ACCELERATORE["F10"]] _
'@RUNVID
...
'@SRP Abbandona()
'@EXITWINDOW
Return
...
'@SRP Salva()
'@DEFVIDMSG MSG["I dati sono stati salvati"]
Return