RUNVID
Mediante la specifica '@RUNVID vengono elaborate tutte le precedenti definizioni della videata (presentazione della videata, attivazione dei tasti funzionali, definizione dei campi di input, ecc.) e quindi viene presentata la videata con la richiesta dei campi di input e l'abilitazione dei tasti funzione. È necessario tenere presente che tutta la parte di definizione della videata che va dalla specifica '@DEFVID (inizio videata) sino alla specifica '@RUNVID (emissione videata) è parte di codice di definizione ed è la specifica '@RUNVID che presenta la videata con le caratteristiche definite prima. Ad ogni specifica '@RUNVID deve corrispondere una specifica '@DEFVID per definire l'inizio della videata.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| DISABILITATO | Condizione | ||||
| OUTPUT | Condizione | ||||
| NASCOSTO | Condizione | ||||
| PROTETTO | Condizione | ||||
| TASTICONTROLLO | |||||
| CONTROLLAVID | Condizione | ||||
| NAVIGAZIONE | |||||
| VALIDAVID | Azione |
DISABILITATO
[EspDisabilitato] Condizione che, se verificata, fa si che i campi di input della videata oggetto di '@RUNVID vengano proposti in solo output. EspDisabilitato: espressione BC il cui valore logico determina la 'disabilitazione' del controllo 'A operatore B' dove 'operatore' può essere '=, >, ≥, <, ≤, <>'. All'interno dell'espressione è possibile utilizzare gli operatori 'AND' e 'OR' per generare istruzioni condizionali composte. <tabella> Dalla versione di ambiente 22.5 il parametro DISABILITATO[] è da considerarsi deprecato, l'ambiente di sviluppo a runtime applica al suo posto il parametro OUTPUT[]. </tabella>
OUTPUT
Permette di indicare la condizione per rendere in output il controllo.
NASCOSTO
[EspNascosto] Condizione che, se verificata, fa si che la videata venga visualizzata nascosta. EspNascosto: espressione BC il cui valore logico determina la 'non visualizzazione' della videata 'A operatore B' dove 'operatore' può essere '=, >, ≥, <, ≤, <>'. All'interno dell'espressione è possibile utilizzare gli operatori 'AND' e 'OR' per generare istruzioni condizionali composte.
PROTETTO
[EspProtezione] L'attributo PROTETTO[] è un'estensione dell'attributo DISABILITATO[] in quanto può determinare la disabilitazione del controllo, analogamente al DISABILITATO[] ma consente di lasciare abilitata l'esecuzione dei controlli e delle decodifiche definite sul controllo. In particolare ad uscita videata: i controlli che prevedono l'attributo DISABILITATO[] con la condizione vera, non sono soggetti ai controlli ed alle decodifiche; i controlli che prevedono l'attributo PROTETTO[] con la condizione vera, sono soggetti ai controlli ed eventualmente alle decodifiche, con relative segnalazioni di errore. L'attributo PROTETTO[] ha rilevanza solamente se le condizioni DISABILITATO[] e NASCOSTO[] sono false. EspProtezione: espressione BC il cui valore logico determina la 'protezione' del controllo 'A operatore B' dove 'operatore' può essere '=, >, ≥, <, ≤, <>'. All'interno dell'espressione è possibile utilizzare gli operatori 'AND' e 'OR' per generare istruzioni condizionali composte. Se l'espressione risulta vera il controllo viene visualizzato disabilitato, in caso contrario risulta editabile.
TASTICONTROLLO
[<ElencoTastiFunzione >] La normale funzionalità di uscita videata, gestita ad esempio con il tasto funzione <F10> o con la doppia chiocciola (@@ per i tasti definiti con '@IVT o CONVARIABILI se definiti con '@DEFFUNCKEY), si occupa di eseguire i controlli su tutti gli edit presenti nella videata e l'uscita riga dall'eventuale griglia presente. Il parametro TASTICONTROLLO, in più, controlla tutte le righe della griglia di input eventualmente definita nella videata e non solo la riga correntemente selezionata (sia che si tratti di griglia paginata che di griglia con CARICATUTTO). ElencoTastiFunzione è l'elenco dei tasti che, una volta premuti, abilitano il meccanismo del controllo sulla videata. È una variabile o costante alfanumerica contenente una sequenza di numeri. La sequenza di identificatori di tasti funzione deve contenere il carattere ',' (virgola) come separatore: -sequenza di valori (ABC%) in una variabile: TASTI$[5]='10,14' TASTICONTROLLO[TASTI$] <tabella> </tabella> <tabella> Valore Tasto Funzione Valore ABC% Significato Descrizione Win 10 F10 10 Memorizza OK 12 END 14 Livello prec. </tabella> E' bene fare attenzione all'utilizzo del parametro TASTICONTROLLO nelle videate multi-pagina. Il parametro TASTICONTROLLO indicato sulla specifica '@RUNVID ha effetto su una videata semplice definita con '@DEFVID/'@RUNVID. Mentre il parametro TASTICONTROLLO indicato sulla '@DEFVIDMPAG ha effetto su tutto il multi-pagina. Se si utilizza una versione di traduttore precedente alla 26.1 è possibile indicare il parametro anche nelle seguenti forme: -sequenza di numeri TASTICONTROLLO[10,12]; -sequenza di identificatori TASTICONTROLLO[F10,END];
CONTROLLAVID
[EspControllo] Condizione che, se verificata, fa si che vengano eseguiti i controlli della videata. Se la specifica '@RUNVID con il parametro CONTROLLAVID[] indicato è riferita ad una '@DEFVID (videata semplice) i controlli su tutti i campi di input e su tutte le righe della griglia di input eventualmente definita nella videata sono eseguiti in uscita dalla videata. Se invece la specifica '@RUNVID con il parametro CONTROLLAVID[] indicato è riferita ad una '@DEFVIDMPAG (videata multi-pagina) i controlli su tutti i campi di input e su tutte le righe della griglia di input eventualmente definita nella videata sono eseguiti in ingresso nella singola videata del multi-pagina. Per maggiori dettagli sui metodi per eseguire i controlli sulle videate consultate la scheda: 'Modalità di controllo delle videate' EspControllo: espressione BC il cui valore logico determina l'esecuzione dei controlli della videata 'A operatore B' dove 'operatore' può essere '=, >, ≥, <, ≤, <>'. All'interno dell'espressione è possibile utilizzare gli operatori 'AND' e 'OR' per generare istruzioni condizionali composte.
NAVIGAZIONE
[cbNavigazione NASCOSTO[FlagSiNo] TASTOCONFERMA[Tasto Funzione] CONFERMA[FlagSiNo] [VARVIDMOD[VariabileVidMod]] ] Attivazione della toolbar di navigazione di un elenco di dati.
VALIDAVID
[cbValidazione] La callback di validazione nasce per racchiudere i controlli e le operazioni di validazione fatte sui campi di una videata dopo la '@RUNVID. L'obbiettivo primario è quello di semplificare il codice BC eliminando le istruzioni sotto la videata e rendendolo, in questo modo, meno procedurale e più ad eventi. <tabella> Per riuscire ad utilizzare il VALIDAVID in contesto RIBBON (multipagina), è necessario dover ridefinire il tasto di validazione all'interno della singola videata. Questo perché il VALIDAVID è di singola videata. Se il tasto non venisse ridefinito il ciclo di vita della Ribbon porterebbe il flusso sulla videata TOP (multipagina), dalla quale non può permettersi di richiamare una callback di un sorgente differente da quello attivo. </tabella> cbValidazione: Callback da chiamare durante la validazione della videata.