DEFCELLGRID
Consente di definire una cella della griglia.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| NOMEGRIGLIA | Intero | ||||
| CELLA | |||||
| VAR | Variabile | ||||
| FMT | Stringa | ||||
| STILE | Stringa | ||||
| INIVAL | Variabile | ||||
| OUTPUT | Condizione | ||||
| NASCOSTO | Condizione | ||||
| DISABILITATO | Condizione | ||||
| PROTETTO | Condizione | ||||
| PROTETTONASCOSTO | Condizione | ||||
| CONTROLLO | |||||
| OBBLIGATORIO | Condizione | ||||
| IN | Azione | ||||
| DECOD | Azione | ||||
| IDAUTORICDEC | Long | ||||
| VARVIDEO | Variabile | ||||
| FMTVIDEO | Stringa | ||||
| VALIDAZIONE | Azione | ||||
| DECODVIDEO | |||||
| NOERRNULL | |||||
| VARDECOD | Variabile | ||||
| CORRELATE | Variabile | ||||
| RIC | |||||
| HELP | Variabile | ||||
| COMMENTO | Variabile | ||||
| CHECKBOX | Intero | ||||
| COMBO | Intero | ||||
| ALTCOMBO | Intero | ||||
| VAL | Variabili | ||||
| OPZIONE | Stringa | ||||
| VALS | Vettore di Variabile | ||||
| OPZIONI | Vettore di Variabile | ||||
| IDMENU | Stringa | ||||
| CAMPOCALCOLATO | Condizione | ||||
| BLOCCATO | Condizione | ||||
| AZIONEBLOCCO | Azione | ||||
| AZIONESBLOCCO | Azione | ||||
| HYPERLINK | Intero | ||||
| AZIONE | Azione | ||||
| AUTOCOMPLETAMENTO | Numerico | ||||
| COLLEZIONECOMBO | Collezione di BC_DA_VALUE_OPTION |
CELLA
Posizionamento del controllo.
Consente di indicare la riga e la colonna.
CELLA[RigaVid], ColonnaVid]
FMT
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.
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.
INIVAL
Valore proposto la prima volta che viene visualizzato il controllo.
OUTPUT
Permette di indicare la condizione per rendere in output il controllo.
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.
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.
CONTROLLO
Consente di verificare se il dato presente nella cella è valido oppure no ed in quest'ultimo caso viene stampato un messaggio di errore.
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 |
OBBLIGATORIO
Consente di indicare l'obbligatorietà del campo.
IDAUTORICDEC
Consente di associare al controllo le funzioni di ricerca e decodifica automatiche definite mediante la specifica @DEFAUTORICDEC.
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
DECODVIDEO
Consente di definire l'azione da eseguire quando il dato a video viene modificato manualmente dall'utente.
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. Questo attributo può essere utilizzato solo se è presente l'attributo DECOD[].
VARDECOD
Consente di definire una variabile per contenere il valore precedente della variabile associata alla cella.
CORRELATE
Consente di forzare la decodifica del controllo, a fronte di una modifica fatta su un edit correlato.
HELP
Attributo di definizione del messaggio di Help
COMMENTO
Consente di definire un tooltip multilinea da associare al campo.
Rimarrà visibile per il tempo in cui il mouse punterà sul campo interessato.
CHECKBOX
Consente di visualizzare il campo di edit come un check box.
COMBO
Consente di indicare la modalità di ricerca opzioni da associare all'edit.
L'attributo è esclusivo rispetto al parametro RIC[].
ALTCOMBO
Dimensione che deve assumere la combo box di ricerca.
VAL
Attributo di definizione di uno dei valori che può assumere la variabile rappresentata nella Combo Box.
Se il parametro è omesso si desume che i valori siano contenuti direttamente nel successivo parametro OPZIONE, secondo la forma 'Valore Descrizione'. Per reperire il valore da assegnare alla variabile di ritorno verrà ricercato il primo spazio: ciò che è alla sinistra sarà il valore.
OPZIONE
Attributo di definizione della descrizione del valore indicato nel precedente parametro VAL[ ].
Nel caso in cui il precedente parametro VAL[] sia presente, il valore di ritorno sarà quello del parametro VAL corrispondente all'opzione selezionata. Nel caso, invece, in cui il parametro non sia presente, il valore si desume dall'opzione andando a ricercare il primo spazio: ciò che è alla sinistra sarà il valore.
VALS
Attributo di definizione dell'insieme di valori che può assumere la variabile rappresentata nella Combo Box.
Se il parametro è omesso si desume che i valori siano contenuti direttamente nel successivo parametro OPZIONI, secondo la forma 'Valore Descrizione'. Per reperire il valore da assegnare alla variabile di ritorno verrà ricercato il primo spazio: ciò che è alla sinistra sarà il valore.
OPZIONI
Attributo di definizione delle descrizioni di tutti i valori indicati nel precedente parametro VALS[ ].
Nel caso in cui il precedente parametro VALS[] sia presente, il valore di ritorno sarà quello del parametro VALS corrispondente all'opzione selezionata. Nel caso, invece, in cui il parametro non sia presente, il valore si desume dall'opzione andando a ricercare il primo spazio: ciò che è alla sinistra sarà il valore.
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ù.
CAMPOCALCOLATO
Consente l'attivazione del meccanismo di protezione da modifiche accidentali di campi calcolati che l'utente eccezionalmente può modificare (ovvero forzarne il valore).
BLOCCATO
Consente la definizione della condizione di blocco del campo da modifiche accidentali. Va usato in unione all'attributo CAMPOCALCOLATO.
AZIONEBLOCCO
Azione che permette di bloccare il campo calcolato da modifiche accidentali. Normalmente in questa call back si imposta la variabile che indica che il campo risulta bloccato e che viene usata per definire la condizione dell'attributo BLOCCATO.
AZIONESBLOCCO
Azione che permette di sbloccare il campo calcolato. Normalmente in questa call back si azzera la variabile che indica che il campo risulta bloccato e che viene usata per definire la condizione dell'attributo BLOCCATO.
HYPERLINK
Flag di definizione di una cella Hyperlink
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
AUTOCOMPLETAMENTO
Consente di definire una query utilizzata per gestire l'autocompletamento.
COLLEZIONECOMBO
Indica il nome della variabile di tipo collezione che conterrà le righe restituite dalla specifica.
L'utilizzo del parametro implica l'utilizzo del parametro COMBO