DEFCELLGRIDADV
Da BC/X 22.0 questa specifica è deprecata. Si consiglia di utilizzare la nuova specifica '@DEFCOLGRIDADV. La specifica '@DEFCELLGRIDADV consente di definire una cella della griglia avanzata, cioè di associare ad una variabile una cella. Consente inoltre di impostare caratteristiche quali:
- il formato e lo stile del dato visualizzato;
- le espressioni che possono disabilitare la cella o nasconderne il testo;
- i valori ammessi della cella;
- gli stili ammessi della cella.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| NOMEGRIGLIA | Intero | ||||
| COL | Intero | ||||
| CELLA | |||||
| COMBO | Intero | ||||
| CAMPOCALCOLATO | Condizione | ||||
| BLOCCATO | Condizione | ||||
| ALTCOMBO | Intero | ||||
| VAL | Variabili | ||||
| OPZIONE | Stringa | ||||
| VALS | Vettore di Variabile | ||||
| OPZIONI | Vettore di Variabile | ||||
| IN | Azione | ||||
| IDMENU | Stringa | ||||
| VARDECOD | Variabile | ||||
| NOERRNULL | |||||
| OUTPUT | Condizione | ||||
| PROTETTO | Condizione | ||||
| PROTETTONASCOSTO | Condizione | ||||
| OBBLIGATORIO | Condizione | ||||
| DECOD | Azione | ||||
| VAR | Variabile | ||||
| FMT | Stringa | ||||
| STILE | Stringa | ||||
| INDICE | |||||
| RIC | |||||
| RAGGRUPPAMENTO | |||||
| NOORDINAMENTO | Intero | ||||
| NORICERCARAPIDA | Intero | ||||
| NOFILTRI | Intero | ||||
| NORIPETIZIONE | |||||
| CHECKBOX | Intero | ||||
| HYPERLINK | Intero | ||||
| AZIONE | Azione | ||||
| COMMENTO | Variabile | ||||
| VALORIAMMESSI | |||||
| VARSTILE | Variabile | ||||
| VALORISTILE | |||||
| VARDISABILITATO | Intero | ||||
| VARNASCOSTO | Intero | ||||
| TOTALI | Intero | ||||
| CONTROLLO | |||||
| HELP | Variabile | ||||
| CORRELATE | Variabile | ||||
| VARVIDEO | Variabile | ||||
| FMTVIDEO | Stringa | ||||
| VALIDAZIONE | Azione |
COL
Indice numerico della colonna su cui si basa la definizione della cella
CELLA
Posizionamento del controllo.
Consente di indicare la riga e la colonna.
CELLA[RigaVid], ColonnaVid]
COMBO
Indica la modalità di ricerca opzioni da associare all'edit
CAMPOCALCOLATO
L'attributo permette l'attivazione del meccanismo di protezione da modifiche accidentali di campi calcolati che l'utente eccezionalmente può modificare (ovvero forzarne il valore)
BLOCCATO
L'attributo permette la definizione della condizione di blocco del campo da modifiche accidentali. Va usato in unione al all'attributo CAMPOCALCOLATO
VAL
Attributo di definizione di uno dei valori che può assumere la variabile rappresentata nella Combo Box
OPZIONE
Attributo di definizione della descrizione del valore indicato nel precedente parametro VAL[]
VALS
Attributo di definizione dell'insieme di valori che può assumere la variabile rappresentata nella Combo Box
OPZIONI
Attributo di definizione delle descrizioni di tutti i valori indicati nel precedente parametro VALS[]
IN
Attributo di definizione dell'azione da eseguire quando la cella prende il fuoco
IDMENU
Consente di specificare il menù di contesto che verrà associato alle celle della riga.
Deve essere definito in precedenza mediante una specifica @DEFCONTEXTMENU. Questo menù verrà visualizzato solo se le celle della riga non dispongono di un proprio menù.
VARDECOD
Attributo che consente di definire una variabile per contenere il valore precedente della variabile associata all'edit
NOERRNULL
Con questo attributo viene effettuata anche la decodifica di un valore 'null' ovvero dello '0' per i campi numerici e del Blank per i campi alfanumerici. Gli eventuali errori non verranno però visualizzati
OUTPUT
Permette di indicare la condizione per rendere in output il controllo.
PROTETTO
Consente di disabilitare il controllo ma lasciare abilitata l'esecuzione dei controlli e delle decodifiche.
PROTETTONASCOSTO
Consente di nascondere il controllo ma lasciare abilitata l'esecuzione dei controlli e delle decodifiche.
OBBLIGATORIO
Attributo indicante l'obbligatorietà del campo
VAR
Variabile o testo costante associato alla cella
FMT
Formato del testo visualizzato nella cella
STILE
Attributo di definizione dello stile da applicare al controllo.
Può essere una delle costanti definite in BC per gli stili oppure uno stile precedentemente definito tramite @DEFSTYLE.
INDICE
Indica per quali campi della struttura dinamica ordinare
RAGGRUPPAMENTO
Indica il raggruppamento sulle colonne della griglia.
NOORDINAMENTO
Definisce l'oggetto grafico come personalizzabile dall'utente in fase di runtime.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
NORICERCARAPIDA
Consente di nascondere, dalla toolbar della griglia, il bottone di ricerca rapida e di disattivare la sua funzionalità dalla griglia avanzata
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | visualizza bottone di ricerca rapida |
1 | nasconde il bottone di ricerca rapida |
NOFILTRI
Consente di eliminare la possibilità, di applicare o meno un filtro in visualizzazione su tutte le colonne della griglia
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | Visualizza bottone di attivazione dei filtri in visualizzazione sulle colonne |
1 | Nasconde il bottone di attivazione dei filtri in visualizzazione sulle colonne |
NORIPETIZIONE
Elenco delle variabili, separate da virgola, relative alle colonne su cui si vuole evitare le ripetizione dei valori
CHECKBOX
Attiva la visualizzazione della colonna tramite checkbox
HYPERLINK
Flag di definizione di una cella Hyperlink
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
COMMENTO
Consente di associare alla cella un commento
VALORIAMMESSI
Elenco di valori ammessi per la cella della griglia
VARSTILE
Variabile contenente il valore di riferimento dello stile associato alla cella
VALORISTILE
Definizione degli stili di cella mediante un elenco esplicito di coppie valore/nome stile
VARDISABILITATO
Variabile che gestisce la disabilitazione dell'azione (hyperlink) sulla griglia avanzata
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
VARNASCOSTO
Variabile che gestisce la visualizzazione del testo sulla griglia avanzata
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
TOTALI
Flag di attivazione dei totali automatici sulla colonna
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
CONTROLLO
Attributo di controllo del valore presente nella cella
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
D | Controllo su campo Data/Periodo. Viene eseguito un controllo per verificare che nel campo sia presente una data valida. Vuoto/Zero non ammesso |
d | Controllo su campo Data/Periodo. Viene eseguito un controllo per verificare che nel campo sia presente una data valida. Vuoto/Zero ammesso |
E | Controllo su campo Cartella/Archivio. Viene eseguito un controllo per verificare che nel campo sia presente un file/directory valida. Vuoto/Zero non ammesso |
e | Controllo su campo Cartella/Archivio. Viene eseguito un controllo per verificare che nel campo sia presente un file/directory valida. Vuoto/Zero ammesso |
T | Controllo su campo Ora. Viene eseguito un controllo per verificare che nel campo sia presente un'ora valida. Vuoto/Zero non ammesso |
t | Controllo su campo Ora. Viene eseguito un controllo per verificare che nel campo sia presente un'ora valida. Vuoto/Zero ammesso |
[ValMin]@[ValMax] | Si definisce un range di valori che deve assumere il campo per essere considerato corretto. ValMin: valore minimo che il campo deve assumere per essere considerato corretto. Nel caso in cui la variabile associata al campo sia di tipo alfanumerico, ValMin può essere una costante alfanumerica racchiusa tra doppi apici o una variabile. Se omesso si assume quale valore minimo il valore minimo inseribile nel campo. ValMax: valore massimo che il campo deve assumere per essere considerato corretto. Nel caso in cui la variabile associata nel campo sia di tipo alfanumerico, ValMax può essere una costante alfanumerica racchiusa tra doppi apici o una variabile. Se omesso si assume quale valore massimo il valore massimo inseribile nel campo |
'Stringa' | Controllo sul campo stringa. Se il campo ha lunghezza 1 carattere, viene eseguito il su descritto controllo mentre se ha lunghezza maggiore di 1 viene eseguito il controllo sul primo carattere del campo di input. Può essere utilizzato solo su campi di input di tipo alfanumerico |
HELP
Attributo di definizione del messaggio di Help
CORRELATE
Attributo di correlazione ad altre celle, ovvero di condizionamento della decodifica della cella in questione in base al valore delle variabili associate alle celle correlate
VARVIDEO
Variabile a video applicativa, diversa dalla variabile di riferimento tecnica, utile per separare fisicamente il comportamento delle variabili per determinate esigenze applicative.
A video comanda e viene visualizzata la variabile applicativa definita nel parametro VARVIDEO[], mentre tutte le funzionalità interne mantengono il riferimento alla variabile tecnica. Se presente il parametro VARVIDEO[], la funzionalità di DECODVIDEO[] si baserà sul suo valore.
L'utilizzo del parametro implica l'utilizzo del parametro FMTVIDEO
FMTVIDEO
Consente di definire il formato del testo visualizzato nella cella.
Questo parametro è obbligatorio per un testo variabile mentre può essere omesso nel caso di testo costante. In questo caso il formato sarà 'TESTO' ed il numero ci caratteri viene determinato direttamente dal testo.
L'utilizzo del parametro implica l'utilizzo del parametro VARVIDEO
VALIDAZIONE
Callback dell'azione da eseguire