SETCELLGRID
Consente di impostare il valore di una determinata cella della griglia e permette di modificarne eventualmente il formato e lo stile.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| NOMEGRIGLIA | Intero | ||||
| CELLA | |||||
| VARCOL | Variabile | ||||
| RIGA | Intero | ||||
| VAL | Variabile | ||||
| VALSTILE | Variabile | ||||
| VALDISABILITATO | Intero | ||||
| VALNASCOSTO | Intero | ||||
| VALEVIDENZIATO | Intero | ||||
| NUOVAVAR | Variabili | ||||
| OBBLIGATORIO | Condizione | ||||
| OUTPUT | Condizione | ||||
| NASCOSTO | Condizione | ||||
| DISABILITATO | Condizione | ||||
| EVIDENZIATO | Condizione | ||||
| PROTETTO | Condizione | ||||
| PROTETTONASCOSTO | Condizione | ||||
| FMT | Stringa | ||||
| STILE | Stringa | ||||
| CONTROLLO | |||||
| COMMENTO | Variabile | ||||
| STATOBOTTONE | Intero | ||||
| COL | Intero | ||||
| FILTRO | |||||
| AUTOCOMPLETAMENTO | Numerico | 30.3 |
CELLA
Posizionamento del controllo.
Consente di indicare la riga e la colonna.
CELLA[RigaVid], ColonnaVid]
L'utilizzo del parametro esclude l'utilizzo dei parametri: VARCOL, COL
VARCOL
Variabile associata alla colonna della cella. Parametro alternativo al parametro CELLA o COL.
L'utilizzo del parametro esclude l'utilizzo dei parametri: CELLA, COL
RIGA
In combinazione con VARCOL, consente di reperire la cella desiderata tramite nome colonna e non tramite coordinata, alternativo a CELLA.
VAL
Variabile o testo costante che sarà visualizzato nella cella.
VALSTILE
Attributo di impostazione di una variabile o di un testo costante nella variabile che gestisce lo stile legato alla cella specifica
VALDISABILITATO
Consente la disabilitazione del bottone sulla griglia avanzata.
La variabile viene valorizzata durante il processo d'inserimento righe della griglia e dal suo valore dipenderà la disabilitazione del bottone della riga che si sta andando ad inserire.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
VALNASCOSTO
Consente la visualizzazione o meno del controllo.
La variabile viene valorizzata durante il processo d'inserimento righe della griglia e dal suo valore dipenderà la visualizzazione del testo (o del pulsante) della riga che si sta andando ad inserire.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
VALEVIDENZIATO
Consente l'evidenziazione del bottone o della cella sulla griglia avanzata.
La variabile viene valorizzata durante il processo d'inserimento righe della griglia e dal suo valore dipenderà la visualizzazione del triangolino rosso del bottone o della cella.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
NUOVAVAR
Nuova variabile associata alla cella su cui è stata operata la modifica del formato (qualora il nuovo formato sia di altro tipo rispetto al precedente) e dello stile.
OBBLIGATORIO
Consente di indicare l'obbligatorietà del campo.
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.
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.
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.
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.
CONTROLLO
Definizione del tipo di controllo del valore presente nella cella. Consente di verificare se il dato presente nella cella è valido oppure no ed in quest'ultimo caso viene emesso 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 |
COMMENTO
Consente di definire un tooltip multilinea da associare al campo.
Rimarrà visibile per il tempo in cui il mouse punterà sul campo interessato.
STATOBOTTONE
Consente di impostare lo stato del bottone dell'albero, se la cella riferita è stata definita mediante la specifica @DEFTREEGRID.
COL
Consente di reperire la cella desiderata tramite coordinata, alternativo a CELLA e VARCOL.
L'utilizzo del parametro esclude l'utilizzo dei parametri: VARCOL, CELLA
FILTRO
Permette di impostare una serie di condizioni di ricerca per la selezione delle righe su cui si vuole impostare la cella.
AUTOCOMPLETAMENTO
Consente di sostituire la query di autocompletamento a seguito di interventi applicativi legati all'esecuzione del programma.