BUTTON_RIBBON
Identifica il comando vero e proprio da inserire sulla ribbon bar.
I bottoni vengono posizionati automaticamente dal controllo, dall'alto verso il basso da sinistra a destra, in base all'ordine d'inserimento sulla specifica.
La ribbon prevede la disposizione in altezza di un massimo di 3 bottoni di piccole dimensioni in verticale o 1 solo di dimensione grande.
Parametri
TIT
Titolo del bottone.
Il titolo viene mostrato al di sotto del bottone in caso di bottone grande, o alla sua destra in caso di dimensione piccola.
ID
Identificativo del bottone all'interno del gruppo.
Normalmente il valore utilizzato corrisponde anche all'identificativo con cui il bottone è stato definito sul foglio di stile.
AZIONE
Azione che deve essere eseguita alla pressione del click sul bottone.
TIPO
Indica il tipo di bottone da aggiungere nella ribbon
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
PLAIN_BUTTON | Bottone semplice, cioè il bottone tradizionale. E' il valore di default per permettere una piena compatibilità con tutti i sorgenti scritti precedentemente all'introduzione del parametro. |
SWITCH_BUTTON | Bottone switch con due stati. Deve essere utilizzato solo per definire stati ed opzioni riguardanti le opzioni di visualizzazione della schermata e non essere legato alle opzioni di analisi dei dati stessi |
TOGGLE_BUTTON | Bottone toggle con due stati. Deve essere utilizzato solo per definire stati ed opzioni riguardanti le opzioni di visualizzazione della schermata e non essere legato alle opzioni di analisi dei dati stessi. |
VALORE
Per i bottoni di tipo SWITCH_BUTTON o TOGGLE_BUTTON, definisce il loro stato iniziale.
Se il bottone è di tipo PLAIN_BUTTON il parametro viene ignorato a prescindere dal valore assunto.
Il valore di questo parametro non viene aggiornato, per recuperare lo stato del bottone è necessario utilizzare la funzione GETRIBBONBUTTONSTATE.
VALIDADATI
Definisce quale validazione eseguire prima dell'azione associata al bottone.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
PROPRIETA | Viene richiamata la validazione della proprietà |
OGGETTO | Viene richiamata la validazione globale dell'oggetto |
NESSUNA | Non viene effettuato alcun tipo di validazione e non viene trasferito il valore video nella relativa variabile |
PROPRIETANORIGA | Viene richiamata la validazione della proprietà senza considerare l'OUTRIGA |
IDFDS
ID del bottone definito sul foglio di stile.
Normalmente il valore inserito nel parametro ID corrisponde anche all'identificativo con cui il bottone è stato definito sul foglio di stile.
Nel caso in cui più di un bottone deve fare riferimento alla stessa definizione sul foglio di stile si può sfruttare il parametro IDFDS: ogni bottone deve avere ID univoco, ma, ma possono avere il medesimo IDFDS.
LINKTO
Permette di legare un bottone ad uno specifico oggetto grafico sulla videata.
- E' possibile ripetere l'attributo per ognuno dei controlli grafici a cui è necessario legarlo.
- Il legame serve a derivare lo stato di Abilitato/Disabilitato e fa sì che il bottone sia presente all'interno del menù contestuale dell'oggetto grafico.
IMMAGINE16
Nome dell'immagine da visualizzare come icona del bottone nella dimensione 'PICCOLO'.
IMMAGINE16 deve essere definita sia per i pulsanti di dimensione piccola che per quelli di dimensione grande, quest'ultimi possono essere ridimensionati e diventare piccoli al ridimensionamento della videata.
L'immagine utilizzata deve avere dimensione 16x16
IMMAGINE32
Nome dell'immagine da visualizzare come icona del bottone nella dimensione 'GRANDE'.
- L'immagine utilizzata deve avere dimensione 32x32
- Se il bottone è definito come GRANDE, ma l'IMMAGINE32 non è definita, il bottone viene automaticamente ridimensionato a PICCOLO
IMMAGINE
Specifica il nome del file contenente l'immagine o la risorsa immagine da visualizzare. Sono supportate solo immagini di tipo BMP e PNG.
NASCOSTO
Permette di indicare la condizione per nascondere il controllo.
La condizione viene applicata solo in fase di creazione della videata (in contesto desktop).
DISABILITATO
Permette di indicare la condizione per disabilitare il controllo.
EVIDENZIATO
Espressione che definisce la condizione per la quale il controllo deve risultare evidenziato. Quando evidenziato, nell'angolo in alto a destra viene visualizzato un triangolino colorato.
Il colore del triangolino varia a seconda del contesto: rosso per desktop, giallo per web.
ACCELERATORE
Esistono due tipi di acceleratori: RIBBON e DIRETTO. Il primo è attivo dalla pressione del solo ALT che, oltre a dare il fuoco al controllo Ribbon, permette di navigare tra Categorie, gruppi e bottoni con shortcut diretti da tastiera (normalmente una lettera). Il secondo, invece, permette di richiamare direttamente l'azione collegata al bottone. Nel secondo caso la definizione degli shortcut è la medesima utilizzata per tasti funzione o tasti di contesto: tasto funzione da F1 a F12 oppure combinazione di Alt+lettera.
CONVARIABILI
La presenza del parametro istruisce il programma ad acquisire le variabili della videata prima di eseguire l'azione richiesta. In pratica corrisponde al formalismo del doppio carattere '@' nella specifica '@IVT. L'indicazione del parametro, quindi, 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.
INVISIBILE
Definisce se il bottone deve essere invisibile o meno.
A differenza del NASCOSTO, il parametro INVISIBILE non blocca l'esecuzione dell'AZIONE tramite shortcut.
COMMENTO
Tooltip multilinea da associare al pulsante.
Il commento rimarrà visibile per il tempo in cui il mouse punterà sul pulsante interessato.
DIMENSIONE
Dimensione del bottone
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
GRANDE | Grande |
PICCOLO | Piccolo |
QUICKACCESSTOOLBAR
Permette di aggiungere il bottone anche alla QAT (Quick Access Toolbar), e in che modalità.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
NO | Il tasto non deve finire all'interno della QAT all'avvio del programma (Default) |
VISIBILE | Il tasto è immediatamente visibile all'interno della QAT e all'interno del menu di contesto associato |
SOLOMENU | Il tasto non è visibile all'interno della QAT, ma è presente all'interno del menu di contesto associato |
BADGE
Valore da inserire all'interno del badge.
RILEVANZA
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
PRIMARIO | |
SECONDARIO | |
LEGGERO | |
ATTENZIONE | |
CONTESTUALE | |
SISTEMIAI |