DEFFUNCKEY
Definisce un tasto funzione della videata.
Per ogni tasto funzione è possibile specificare un messaggio di help associato al tasto e una o più istruzioni da eseguire nel caso il tasto venga premuto.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| TASTO | |||||
| VAR | Variabile | ||||
| ID | Stringa | ||||
| CONVARIABILI | Intero | ||||
| AZIONE | |||||
| NASCOSTO | Condizione | ||||
| DISABILITATO | Condizione | ||||
| INVISIBILE | Intero | ||||
| ORDINE | Intero | ||||
| IMMAGINE | Variabile | ||||
| POSIMMAGINE | Enumerazione | ||||
| EVIDENZIATO | Condizione | ||||
| BADGE | Variabile | ||||
| MENU |
TASTO
Identifica il tasto funzionale da abilitare.
La seguente tabella riporta i valori del parametro Tasto con il relativo tasto funzione e il valore di ABC% ritornato dalla specifica '@RUNVID:
| Tasto Funzione | Valore ABC% | Significato | Descrizione Win |
|---|---|---|---|
| F1 | 1 | Ripristino | Abbandona |
| F2 | 2 | Help | Help |
| F3 | 3 | ||
| F4 | 4 | ||
| F5 | 5 | ||
| F6 | 6 | Ricerca | Ricerca |
| F7 | 7 | ||
| F8 | 8 | ||
| F9 | 9 | ||
| F10 | 10 | Memorizza | OK |
| F11 | 25 | ||
| F12 | 26 | ||
| ESC | 11 | Fine lavoro | Chiudi |
| END | 14 | Livello prec. | |
| PGUP | 19 | Pagina Prec. | Prima pagina |
| PGDN | 20 | Pagina Succ. | Pagina Succ. |
Dalla versione 26.1 del traduttore, il valore del parametro va indicato tra doppi apici.
VAR
Attributo indicante il testo da visualizzare nel BOTTONE.
ID
Definisce la variabile o la costante di programma che contiene l'identificatore univoco del controllo.
Viene utilizzato dall'ambiente per gestire le personalizzazioni effettuate durante l'esecuzione del programma.
CONVARIABILI
La presenza del parametro istruisce il programma ad acquisire le variabili della videata prima di eseguire l'azione richiesta.
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.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
AZIONE
Definizione dell'azione da eseguire quando il bottone viene premuto con il mouse o mediante l'acceleratore.
NASCOSTO
Attributo che consente di nascondere il tasto funzione.
All'interno dell'espressione è possibile utilizzare gli operatori 'AND' e 'OR' per generare istruzioni condizionali composte. Se l'espressione risulta vera il tasto viene nascosto, in caso contrario viene visualizzato. Se non è presente questo attributo il tasto risulta visibile.
DISABILITATO
Attributo di disabilitazione del tasto funzione.
Se il bottone non è abilitato sarà in 'grigetto'. Se l'espressione risulta vera il tasto viene disabilitato.
Se non è presente questo attributo il tasto risulta abilitato.
INVISIBILE
Attributo per rendere invisibile il tasto funzione senza però disabilitarlo. Ovvero, il tasto funzione, pur non essendo presente a video, è attivabile tramite tastiera.
ORDINE
Permette di definire l'ordine di 'apparizione' dei tasti funzione sulla barra dei bottoni. L'ordine d'ufficio dei tasti funzione è il seguente:
- <INVIO (F10)>
- <F1>
- <ESC>
- <F2>
- <F3>
- <F4>
- <F5>
- <F6>
- <F7>
- <F8>
- <F9>
- <F11>
- <F12>
- <END>
- <PGUP>
- <PGDN>
- <Shift (F1)>. OrdineTasto: valore numerico costante che permette di specificare la posizione ordinale del tasto funzione. La prima posizione ha valore 1.
IMMAGINE
Specifica il nome del file contenente l'immagine o la risorsa immagine da visualizzare.
Sono supportate solo immagini di tipo BMP o PNG.
POSIMMAGINE
Indica la posizione dell'immagine e quindi del testo.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
ALTO | Immagine sopra e testo sotto |
BASSO | Immagine sotto e testo sopra |
SINISTRA | Immagine a sinistra e testo a destra (DEFAULT) |
DESTRA | Immagine a destra e testo a sinistra |
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.
MENU
Permette di associare un menù contestuale al tasto funzione.
L'esecuzione del menù associato avviene solo premendo nell'area destra del tasto funzione, dove è disegnata la freccina. L'esecuzione del menù contestuale non effettua l'uscita dalla videata né la valorizzazione della variabile globale ABC%.