DEFVIDMPAG
Consente la definizione di una videata composta, costituita da un numero variabile di videate
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| IDMPAG | Stringa | ||||
| ID | Stringa | ||||
| INTESTAZIONE | |||||
| PAGINACORRENTE | Stringa | ||||
| GES | Azione | ||||
| RIBBONBAR | |||||
| TIT | Variabile | ||||
| SOTTOTITOLO | Variabile | 29.4 | |||
| CONTROLLAPAG | |||||
| NASCOSTO | Condizione | ||||
| DISABILITATO | Condizione | ||||
| PROTETTO | Condizione | ||||
| PROTETTONASCOSTO | Condizione | ||||
| EVIDENZIATO | Condizione | ||||
| IMMAGINE | Stringa | ||||
| POSIMMAGINE | Enumerazione | ||||
| NASCOSTOMPAG | Condizione | ||||
| TASTICONTROLLO | |||||
| CONTROLLAPAGCOR | Intero | ||||
| SELETTORE | |||||
| POSIZIONETAB | Enumerazione | ||||
| LIVELLO | Intero | ||||
| SELEZIONABILE | Intero | ||||
| TABRIDOTTI | Intero | ||||
| VALIMMAGINE | Intero | ||||
| STILE | Stringa | ||||
| STATO | Stringa | ||||
| PAGINAATTIVA | Variabile | ||||
| AZIONE | Azione |
IDMPAG
Definisce la variabile o la costante di programma che contiene l'identificatore univoco del controllo multipagina
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.
INTESTAZIONE
Definisce una sequenza di istruzioni in cui viene definita la videata di intestazione.
PAGINACORRENTE
Sostituisce la variabile d'ambiente ZVIDCOMP, permette di indicare la pagina con la quale si deve aprire il multipagina. A differenza di ZVIDCOMP, il parametro si basa sugli identificativi di pagina.
IndicePagina: può essere una costante o una variabile di tipo alfanumerico.
GES
Definisce una sequenza di istruzioni in cui è presente la gestione della pagina; questa azione è eseguita quando viene selezionata la pagina sull'interfaccia utente, mediante tastiera o mouse.
RIBBONBAR
Consente l'indicazione dei contesti applicativi relativi alle categorie della Ribbon Bar da attivare.
La stringa può contenere più contesti applicativi separati da virgola.
ContestoCategoria: costante o variabile di tipo stringa.
TIT
Definisce il titolo da visualizzare sul selezionatore di pagina presente sulla dialog multipagina; il titolo eventualmente definito sulle singole videate associate alle pagine è ignorato in questo contesto.
Se il titolo è contenuto all'interno di una variabile, è possibile modificarne in esecuzione il valore; questa variazione sarà recepita sul primo cambio pagina.
SOTTOTITOLO
Definisce il sottotitolo da visualizzare sul selettore verticale delle pagine presenti sulla dialog multipagina.
Sottotitolo: stringa costante o variabile di tipo stringa.
CONTROLLAPAG
Definisce quali pagine del multipagina devono essere eseguite in modalità 'controllo' prima di visualizzare in gestione la pagina selezionata.
Numero Pagine: Può essere una costante o una variabile di tipo intero
NASCOSTO
È un'espressione che definisce una condizione per la quale una specifica pagina non deve essere riportata nel selezionatore. Questa condizione è valutata solamente al momento della creazione della videata composta; eventuali variazioni successive della condizione, che renderebbero la pagina 'visibile' non sono recepite.
DISABILITATO
È un'espressione che definisce una condizione per la quale una specifica pagina non può essere selezionata. La pagina resta visibile come titolo nel selezionatore di pagina ma non può essere attivata. La condizione è dinamica e viene valutata e recepita ad ogni cambio pagina.
PROTETTO
È un'espressione che definisce una condizione per la quale una specifica pagina risulta protetta.
L'indicazione di questo parametro è equivalente all'indicazione del parametro PROTETTO sulla specifica RUNVID della pagina.
PROTETTONASCOSTO
È un'espressione che definisce una condizione per la quale una specifica pagina non può essere selezionata in quanto 'protetta-nascosta'.
La pagina resta visibile come titolo nel selezionatore di pagina in ROSSO, ma non può essere attivata.
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.
IMMAGINE
Specifica il nome del file contenente l'immagine o la risorsa immagine da visualizzare nella etichetta della pagina (Non viene considerata per il selettore di tipo WIZARDVERTICALE)
NomeImmagine: stringa costante o variabile di tipo stringa.
L'immagine deve essere definita con le seguenti caratteristiche: dimensioni 32 x 16 pixel; composta di due sottoimmagini 16 x 16 pixel; la prima sottoimmagine è usata quando la pagina è abilitata, la seconda sottoimmagine quando la pagina è disabilitata.
POSIMMAGINE
Indica la posizione dell'immagine rispetto il testo dell'etichetta.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
SINISTRA | Sinistra |
DESTRA | Destra |
NASCOSTOMPAG
È un'espressione che definisce una condizione per cui il selezionatore di pagine non deve essere visualizzato. L'effetto visivo che si ottiene è quello di una videata composta da un'unica pagina, su cui però è possibile modificare la pagina visualizzata agendo direttamente sulla variabile ZVIDCOMP.
TASTICONTROLLO
Consente l'esecuzione riassuntiva dei controlli di ogni singola videata componente evitando all'operatore di 'passare' su ogni singola videata per realizzare la medesima operazione manualmente.
ElencoTastiFunzione è l'elenco dei tasti che, una volta premuti, abilitano il meccanismo del controllo sulle videate del multi-pagina. È una variabile o costante alfanumerica contenente una sequenza di numeri.
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). I controllo sono eseguiti su tutte le videate definite nel multi-pagina.
E' bene fare attenzione all'utilizzo del parametro TASTICONTROLLO nelle videate multi-pagina. Il parametro TASTICONTROLLO indicato sulla specifica '@DEFVIDMPAG ha effetto su tutto il multi-pagina. Mentre il parametro TASTICONTROLLO indicato sulla specifica '@RUNVID ha effetto su una videata semplice definita con '@DEFVID/'@RUNVID.
CONTROLLAPAGCOR
Indica se, in fase di applicazione dei TastiControllo, è necessario controllare ulteriormente la pagina corrente.
FlagControllaPaginaCorrente: flag per indicare il controllo anche della pagina corrente (0-No;1-Si)
Precisazioni su utilizzo di TASTICONTROLLO[] e CONTROLLAPAGCOR[] Quando viene premuto uno dei tasti compresi in TASTICONTROLLO[] si attiva il seguente processo:
- verifica della pagina corrente su cui si è posizionati, come normale processo di verifica della pagina;
- verifica delle altre pagine del multipagina, esclusa la pagina corrente.
Se è stato indicato anche il parametro CONTROLLAPAGCOR[] viene rieseguita la verifica della pagina corrente. Tale parametro è utile se le altre pagine del multi-pagina effettuano modifiche ai dati ed è quindi necessario effettuare una ulteriore verifica della pagina corrente. Per maggiori dettagli sui metodi per eseguire i controlli sulle videate consultate la scheda: 'Modalità di controllo delle videate'
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
SELETTORE
Permette di definire come gestire il selettore della videata multipagina.
POSIZIONETAB
Permette di definire la posizione del selettore di pagina orizzontale. Il selettore può essere nella parte superiore della videata (Standard), o inferiore (Simil Excel). PosizioneTab: deve essere uno dei valori sotto indicati.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
SOPRA | Sopra |
SOTTO | Sotto |
LIVELLO
Utilizzabile esclusivamente con SELETTORE di tipo GERARCHICO.
Il livello indica l'indentazione della pagina all'interno del selettore gerarchico. Lo 0 rappresenta la ROOT ogni livello può essere figlio o parallelo dei precedenti. L'ordine di visualizzazione è dato dall'ordine di inserimento all'interno della specifica
LivelloIndentazione: Può essere una costante o una variabile di tipo intero
SELEZIONABILE
Flag che identifica se la pagina può essere selezionata da tastiera e mouse.
FlagSelezionabile: può essere una variabile o una costante di tipo intero.
Se il parametro è negativo, la sua selezione non produrrà nessun effetto nel ciclo di vita del multipagina.
Tale attributo viene considerato esclusivamente per il multipagina di tipo gerarchico/verticale.
TABRIDOTTI
Permette di ridurre la dimensione delle linguette di selezione della singola pagina (SELETTORE ORIZZONTALE).
TabRidotti: può essere una costante o una variabile di tipo numerico.
Con la dimensione ridotta è possibile condensare più pagine all'interno dello spazio visibile della videata.
VALIMMAGINE
Utilizzabile esclusivamente con SELETTORE di tipo GERARCHICO o VERTICALE. Identifica corrispondente all'immagine associata all'elemento. Il valore contenuto deve corrispondere ad uno dei valori introdotti all'interno del set d'immagini definite attraverso il parametro VALORIAMMESSI.
VALOREIMMAGINE: può essere una costante o una variabile di tipo numerico.
STILE
Identifica l'attributo di definizione dello stile da applicare al singolo nodo dell'albero generato dalla pagina su cui è applicato. StileLivello: può essere una delle costanti definite in BC per gli stili, o un nuovo stile precedentemente definito con una specifica @DEFSTYLE
Utilizzabile esclusivamente con SELETTORE di tipo GERARCHICO.
STATO
Il parametro è opzionale esclusivamente se definito il selettore WIZARDVERTICALE, altrimenti il parametro non viene considerato. Indica lo stato della pagina corrente, dallo stato viene derivata l'icona (d'ambiente) da associare nel selettore verticale (WIZARDVERTICALE).
StatoPagina: Può essere una variabile o una costante alfanumerica.Può avere i seguenti valori:
| Valore | Descrizione |
|---|---|
| COMPLETA | La pagina è stata completata in ogni suo punto e il wizard ha proseguito oltre |
| WARNING | La pagina è stata completata ma il programma vuole attirare l'attenzione dell'utente perché ci possono essere dei potenziali problemi o avvisi |
| SALTATA | La pagina è stata saltata |
PAGINAATTIVA
Consente di definire la pagina selezionata all'interno del multipagina. All'avvio verrà eseguita l'azione relativa della pagina selezionata (in questo caso la pagina attiva) PaginaAttiva: Può essere una costante o una variabile di tipo intero.
AZIONE
Ad ogni cambio pagina viene eseguita l'azione associata. AzioneCambio: call-back associata al cambio pagina
Esempi
Esempio creazione multipagina
'@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata"] NOME[VideataEsempio1_1] RIBBON[IDRIBBON["IDRibbonEsempio"]]
'@DEFRIBBONBAR NOME[Esempio1] IDRIBBONBAR["IDRibbonEsempio1_1"] _
CATEGORIA[ID["IDCategoria"] TIT["Azioni"] _
GRUPPO[ID["Gruppo1"] TIT["Navigazione"] _
BOTTONE[ID["SYS_EXIT"] TIT["Abbandona"] AZIONE[Abbandona()]] _
BOTTONE[ID["SYS_OK"] TIT["Conferma"] AZIONE[Conferma()]] _
] _
]
'@DEFVIDMPAG INTESTAZIONE[Testata()] _
TIT["Dati anagrafici"] GES[DatiAnagrafici()] _
TIT["Dati accessori"] GES[DatiAccessori()]_
TIT["Altri dati"] GES[AltriDati()]
'@RUNVID