DEFVID
La specifica '@DEFVID definisce una videata.
Parametri
DIM
Dimensione del controllo.
Consente di indicare l'altezza e la larghezza. Per entrambi è possibile specificare l'unità di misura.
DIM[Altezza [UnitàMisura], Larghezza [UnitàMisura]]
L'unità di misura può essere: 'C' per il posizionamento a caratteri e 'P' per il posizionamento in pixel. L'indicazione è opzionale, se omesso si assume 'C' come default.
NOME
Nome della videata. Serve a definire l'oggetto videata nel sorgente e chiamare i suoi metodi. NomeVid: variabile interna autodefinita. Non richiede di essere dimensionata.
FONTEDATI
Variabile Record valorizzata col contenuto della riga corrente
MODELLODATI
[NomeOggetto] Parametro predisposto per la gestione MVC. Definisca l'associazione tra videata e oggetto che rappresenta. NomeOggetto: classe semplice o composta da associare alla videata.
DIMPANNELLO
[[Altezza [TipoCoord],] Larghezza [TipoCoord]] Dimensioni effettiva del pannello. Altezza: altezza del pannello in numero di righe; può essere indicato con una costante oppure mediante una variabile. Se il numero di righe del pannello è superiore al numero di righe della videata, la videata visualizza una scrollbar verticale per permettere all'utente lo scorrimento del pannello all'interno della finestra. Larghezza: larghezza del pannello in numero di caratteri; può essere indicato con una costante oppure mediante una variabile. Se il numero di colonne del pannello è superiore al numero di colonne della videata, la videata visualizza una scrollbar orizzontale per permettere all'utente lo scorrimento del pannello all'interno della finestra. TipoCoord: unità di misura utilizzata per i due parametri precedenti. Può assumere i seguenti valori:
POS
La specifica '@DEFVIDPOS consente di eseguire il posizionamento su un determinato controllo di una videata, mediante l'indicazione dell'ID o del nome del controllo o della variabile associata.
TIT
[Titolo Videata] 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. Nel caso di stringa costante deve essere racchiuso fra doppi apici. Se il titolo è contenuto all'interno di una variabile, è possibile modificarne in esecuzione il valore; questa variazione sarà recepita sul primo cambio pagina.
SOTTOTITOLO
Sottotitolo che viene visualizzato nella testata della videata
DIAGRAMMATABELLE
[NomeDiagramma] Nome del file che contiene il diagramma delle tabelle SQL associate e referenziate dalla videata descritta dalla specifica. Il risultato che si ottiene è l'aggiunta di un pulsante di sistema
- nella ribbon bar (se è definita la ribbon tramite la specifica '@DEFRIBBONBAR)
- nel pulsante di help se la ribbon non è stata definita nella videata Il pulsante viene mostrato solo se l'operatore è autorizzato alla visualizzazione del diagramma stesso. Alla pressione del pulsante il diagramma viene aperto all'interno di SISDiagram in sola visualizzazione (cioè il diagramma non è editabile) NomeDiagramma: nome del file, SENZA l'estensione, contenente il diagramma delle tabelle SQL.
TITSCHEDA
[TitoloScheda] Titolo che viene visualizzato sulla finestra del browser. TitoloScheda: deve essere racchiuso fra doppi apice se costante, altrimenti può essere una variabile alfanumerica.
TOOLBAR
Definizione di una toolbar di azioni gestite da programma
RIBBON
[IDRIBBON[NomeRibbonbar] ] Identificativo della Ribbon Bar di videata, definita precedentemente tramite specifica '@DEFRIBBONBAR. NomeRibbonBar: costante o variabile alfanumerica che indica l'identificativo della Ribbon Bar da associare alla videata
NASCOSTOTIT
[Flag] Consente di nascondere il titolo della videata.
NOMODULO
[FlagNoModulo] Se indicato, nel titolo della finestra non è aggiunto il nome del modulo (il nome del modulo è aggiunto alle finestre 'base' del programma). Obsoleto: Il parametro è obsoleto a partire dalla versione 30.3. A partire da questa versione il nome del programma non viene più scritto nel titolo della videata ma nella statusbar della videata stessa.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
POPUP
[FlagPopup] Se presente, indica che la finestra dovrà apparire in primo piano (sopra le altre finestre), al di fuori del contesto di definizione delle videate composte/mutipagina. Quest'attributo permette di visualizzare delle finestre 'temporanee' nel contesto di definizione delle videate composte (vedete esempio). <tabella> La finestra POPUP deve essere una finestra semplice (non sono gestite finestre MULTIPAGINA o COMPOSTE). La finestra POPUP va collocata in una sub interna, richiamata dalla sub di gestione della videata componente del MULTIPAGINA o della videata COMPOSTA. </tabella>
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
ID
[IdentificativoPagina] Permette di identificare ogni pagina definita con un id esplicito e fisso. Tale identificativo verrà poi utilizzato nel momento in cui si procederà con l'aggiornamento delle immagini (Selettore verticale/gerarchico), o il salvataggio delle opzioni. IdentificativoPagina: stringa costante o variabile di tipo stringa.
IDSCREEN
Identificativo personalizzazione in sostituizione del percorso multipagina/composta
SALVAPOS
[Flag] Abilita il salvataggio della posizione e della dimensione della videata (e la rilettura prima di visualizzarla). Per il salvataggio della dimensione e della posizione viene utilizzato come identificatore della videata il nome indicato con il parametro ID[] (non gestito).
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
VIDBASE
[vidBase] Definisce la videata come videata base dell'applicazione. Un'applicazione può prevedere più videate che presentano questo attributo (vengono comunque rimosse anche le videate che prevedono l'attributo VIDBASE[]). vidBase: può essere una costante o una variabile di tipo intero.. Il parametro può assumere i seguenti valori: <tabella> Valore parametro Significato 0 La videata emessa è successiva alla precedente, si vedono entrambe. 1 La videata emessa è l'unica visualizzata, le precedenti vengono distrutte e poi ricreate attraverso il ciclo di vita delle videate 2 La videata emessa è l'unica visualizzata, le precedenti vengono nascoste, e ri-visualizzate automaticamente alla chiusura della videata con VIDBASE = 2. </tabella>
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
PRIMOPIANO
[FlagPrimoPiano] Mantiene sempre in primo piano la videata anche quando questa perde il focus; il comportamento è identico a quello della finestra windows del task manager. Può essere indicato con un valore costante 0/1 oppure mediante una variabile.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
CORNICE
[Flag] Indica la costruzione di un bordo tridimensionale che racchiude tutti i controlli definiti sulla videata. Il default prevede la creazione della cornice. Eventualmente può essere utilizzato l'argomento Flag per indicarne la visualizzazione (valore 1) o meno (valore 0). Nel caso in cui la videata prevede un controllo griglia, o albero od editor, la cornice comunque non viene visualizzata.
RIDIMENSIONABILE
[Flag] Definisce che la dialog può essere ridimensionata.
TASTOPERCHIUSURA
[TastoFunzione] Indica il tasto funzione utilizzato per chiudere la finestra, d'ufficio si assume il tasto ESCAPE (11). TastoFunzione: è il valore da utilizzare e può essere espresso nella forma: - valore numerico che identifica il tasto definito mediante '@IVT (il numero da indicare è esattamente quello che precede il carattere @ sulla specifica '@IVT (1,2,3...11 ecc..) - Identificatore del tasto funzione definito mediante '@DEFFUNCKEY (F1,F2,...ESC, ecc...) - variabile ALFANUMERICA. In questo caso il valore contenuto nella variabile deve rappresentare un codice numerico '@IVT Dalla versione 26.1 del traduttore, il valore del parametro va indicato tra doppi apici.
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.
La caratteristica per ora utilizzabile è il colore di sfondo.
PALETTE
Permette di definire una gestione grafica trasversale ai temi grafici.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
BASE | Default senza disegno delle righe dei pannelli |
DEFAULT_AMB | Default con disegno delle righe dei pannelli |
FISCALE_730 | Modello 730 |
FISCALE_RPF | Modello redditi persone fisiche |
FISCALE_RSP | Modello redditi società di persone |
FISCALE_RSC | Modello redditi società di capitale |
FISCALE_ENC | Modello redditi enti non commerciali |
FISCALE_IRP | Modello IRAP |
FISCALE_IVA | Modello IVA |
FISCALE_IVF | Modello IVA 74 bis |
FISCALE_770 | Modello 770 |
FISCALE_77C | Certificazione Utili |
FISCALE_CNM | Consolidato Nazionale e Mondiale |
FISCALE_ISAA | Modello ISA - Agricoltura |
FISCALE_ISAC | Modello ISA - Commercio |
FISCALE_ISAM | Modello ISA - Manifatture |
FISCALE_ISAP | Modello ISA - Professioni |
FISCALE_ISAS | Modello ISA - Servizi |
FISCALE_CLI | Comunicazione liquidazioni periodiche IVA |
FISCALE_CBL | Comunicazione Polivalente |
FISCALE_INT | Elenchi INTRASTAT |
FISCALE_DDI | Dichiarazione d'intento |
FISCALE_RIVT | Rimborso IVA |
FISCALE_CU | Certificazione Unica |
FISCALE_DAS | Dichiarazione aiuti di stato |
FISCALE_WED | Istanza contributo a fondo perduto Wedding |
FISCALE_RIS | Istanza contributo a fondo perduto Horeca |
AMBIENTE_WHITE | Istanza contributo a fondo perduto Horeca |
FISCALE_CPB | Concordato Preventivo Biennale |
IMMAGINE
[NomeImmagine] 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. Per maggiori informazioni consultare la scheda NomeImmagine. 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. <tabella> Quando si specifica un nome immagine mediante una variabile stringa, è possibile ottenere l'effetto di aggiornamento dell'immagine per una pagina al passaggio da una pagina ad un'altra. </tabella>
IMMAGINETIT
Definisce il nome dell'immagine da utilizzare nel titolo
POSBOTTONI
[Posizione] Indica la posizione in cui visualizzare i bottoni della videata. Posizione: può essere uno dei valori della tabella sotto indicata: <tabella> Valore parametro Valore variabile Significato #BASSODESTRA 13 In basso a destra rispetto alla videata precedente, in ordine di visualizzazione. #BASSOCENTRO 14 In basso ed al centro rispetto alla videata precedente, in ordine di visualizzazione. #BASSOSINISTRA 15 In basso ed a sinistra rispetto alla videata precedente, in ordine di visualizzazione. #SINISTRAALTO #SINISTRACENTRO #SINISTRABASSO #DESTRAALTO #DESTRACENTRO #DESTRABASSO #ALTODESTRA 16 In alto a destra rispetto alla videata precedente, in ordine di visualizzazione. #ALTOCENTRO 17 In alto ed al centro rispetto alla videata precedente, in ordine di visualizzazione. #ALTOSINISTRA 18 In alto a sinistra rispetto alla videata precedente, in ordine di visualizzazione. </tabella> Se non viene indicato nulla si utilizza il posizionamento in basso a destra. HELP- (Input, Opzionale) [HelpVid] Help associato alla videata. HelpVid: è una costante o variabile alfanumerica in cui indicare quale help associare alla videata. Deve essere espressa nella seguente forma: <Nome file Help .CHM>:<Nome scheda di help>[:<Bookmark>]. Può essere indicata anche la parola riservata NOHELP che inibisce la gestione della scheda di help per la videata corrente (non viene ricercata la scheda di help associata e non viene visualizzato il relativo tasto Shift+F1).
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
BASSODESTRA | BASSODESTRA |
BASSOCENTRO | BASSOCENTRO |
BASSOSINISTRA | BASSOSINISTRA |
SINISTRAALTO | SINISTRAALTO |
SINISTRACENTRO | SINISTRACENTRO |
SINISTRABASSO | SINISTRABASSO |
DESTRAALTO | DESTRAALTO |
DESTRACENTRO | DESTRACENTRO |
DESTRABASSO | DESTRABASSO |
ALTODESTRA | ALTODESTRA |
ALTOCENTRO | ALTOCENTRO |
ALTOSINISTRA | ALTOSINISTRA |
HELP
Help associato alla videata
STATUSBAR
[nStatusBar] Permette la visualizzazione o l'occultamento della status bar per la finestra che si sta definendo, l'attributo può essere specificato per una finestra che non sia contenuta come finestra componente di una finestra composta o multipagina. nStatusBar: costante o variabile numerica che specifica lo stato di visualizzazione della barra di stato della finestra, se vale 1 la barra di stato è visibile, se vale 0 la barra di stato sarà invisibile, se l'attributo STATUSBAR non è specificato, la barra di stato è visibile d'ufficio.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | la barra di stato è invisibile |
1 | la barra di stato è visibile |
IDMENU
[IdMenu] Permette di specificare se la videata dispone di un menù di contesto definito in precedenza mediante una specifica '@DEFCONTEXTMENU. IdMenu: deve essere racchiuso fra doppi apici se costante, altrimenti può essere una variabile alfanumerica. Rappresenta l'identificatore tramite il quale è stato definito il menu di contesto.
DIMENSIONAMENTOAUTOMATICO
[FlagSiNo] Il parametro può essere utilizzato esclusivamente se la videata è definita attraverso l'utilizzo dei LAYOUT DINAMICI. Permette di accorpare la videata, in altezza e in larghezza.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
ATTIVAZIONE
[AzioneAttivazione] Permette di definire un'azione di programma quando la finestra viene attivata dall'utente. L'indicazione dell'attributo è preso in considerazione solo per le finestre semplici. Per le finestre composte/multipagina è necessario definire l'attributo nelle singole pagine o finestre componenti. Di volta in volta sarà chiamata l'unica callback relativa alla finestra in quel momento in esecuzione. AzioneAttivazione: richiamo ad una '@SR del programma e ad eventuali istruzioni BC. <tabella> Non è consentito inserire le istruzioni 'GOTO'. </tabella>
ONLOAD
[cbLoad] Evento di caricamento iniziale. Il suo richiamo avviene dopo aver creato gli oggetti grafici ma prima della loro visualizzazione, cronologicamente viene richiamato prima della Load dei singoli controlli (es.prima del caricamento delle righe di una griglia). La callback può venir richiamata per caricare il modello dati, o per modificare alcuni aspetti dell'oggetto grafico (@SETRIBBONBADGE). cbLoad: richiamo ad una '@SR del programma e ad eventuali istruzioni BC. <tabella> Non è consentito inserire le istruzioni 'GOTO'. </tabella>
SYSTEMTRAY
[FlagSystemTray] Se presente, indica che la finestra dovrà apparire nella 'system tray' e non nella taskbar quando l'applicazione è minimizzata. Quest'opzione va usata congiuntamente alla variabile ZVIDSTATOVIS per visualizzare i programmi di tipo 'servizio' nella system tray. L'icona nella system tray presenta come fumetto il titolo della finestra. Se la finestra possiede un menù (attributo IDMENU) questo è visualizzato alla pressione del bottone destro del mouse sopra l'icona dell'applicazione nella system tray.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
CONTESTOPERS
[ContestoDiEsecuzioneUI] Indica il contesto di esecuzione per singola videata. A seconda del contesto definito, la singola videata viene salvata su un file di personalizzazione cosi composto: <NomeModulo/dll>_<CONTESTOPERS>.SXV[D/E] In caso di videata composta, se non indicato, il contesto di esecuzione viene derivata dalle videata padre (Composta, multipagina, ecc..). Può essere modificato a runtime utilizzando la specifica @RESETCONTEXTINTERFACE. Per maggiori dettagli consultare la scheda 'Personalizzazione Interfaccia Utente - Argomento' ContestoDiEsecuzioneUI: Può essere una costante o una variabile di tipo alfanumerico. Esempio NOHELP <tabella> BC '@DEFVID ... HELP[NOHELP] </tabella> Esempio richiamo HELP <tabella> BC @DEFVID DIM[] ... _ HELP['SISFORM.CHM:PROPRIETA' OGGETTI.HTM:RETTANGOLO'] </tabella> Nome file Help .CHM: è il nome del file che contiene l'help di prodotto, è opzionale indicare l'estensione CHM, se non indicata viene assunta di default. Nome scheda di help: è il nome del file che contiene la singola scheda, solitamente di tipo .HTM. Se l'estensione non è indicata viene assunto di default .HTM. Bookmark: è il bookmark a cui si vuole fare riferimento all'interno di una singola scheda per posizionarsi ad un certo punto della stessa, è opzionale. Nel caso sia indicata una variabile è consigliabile utilizzare la variabile ZNOMEHELP$ (per facilitare il collegamento con le utility di Agis), la quale deve essere dimensionata nel sorgente a 255 caratteri e strutturata al suo interno allo stesso modo della stringa costante, cioè con i caratteri separatori dei vari parametri.
PERSONALIZZABILE
[FlagSiNo] Se abilitato, indica che la videata può essere personalizzata a runtime dall'utente. Permette inoltre la sua configurazione. FlagSiNo: Può essere una costante o una variabile di tipo intero. Per maggiori dettagli consultare la pagina: 'Personalizzazione Interfaccia Utente - Personalizzazione della videata'
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
LINKVID
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.
HELPCONTEXT
[HelpContext] Indica il contesto da applicare per la ricerca della scheda di help relativa alla videata. HelpContext: costante o variabile alfanumerica di 50 caratteri. Il nuovo parametro va preferito all'utilizzo della variabile di ambiente ZHELPCONTEXT$.
VALIDAZIONE
VIDEATA[AzioneValidazione] RECORDSET[RecordsetErrori] Parametro predisposto per la gestione non MVC della validazione. Definisce l'azione per la validazione e la collezioni di classi sul quale verranno caricati gli errori. AzioneValidazione: Call-back di richiamo al metodo di validazione. Viene eseguita dai bottoni della toolbar e dai bottoni normali quando hanno il parametro VALIDADATI = #OGGETTO RecordsetErrori: Collezioni di classi sul quale verranno caricati gli errori. Gli errori verranno mostrati a video se è stata richiamata la call-back di validazione o se sulle DEFEDIT hanno il parametro VALIDADATI = #OGGETTO ed è stata richiamata la call-back associata a DECODEVIDEO[GES[]]
VALIDAZIONEDATI
GES[cbValidaDati] DERIVAZIONEDATI[cbDerivaDati] PROPRIETACORRENTE[ProprietàCorrente] Parametro predisposto per la gestione MVC e correlato al MODELLODATI. Definisce i metodi per la validazione e derivazione dei dati modificati sull'oggetto a cui la videata fa riferimento. cbValidaDati: Call-back di richiamo al metodo di validazione del modello dati. Eseguita ad ogni modifica di una cella della griglia e ad uscita riga. cbDerivaDati: Call-back di richiamo al metodo di derivazione dati della classe. Viene eseguita successivamente alla validazione delle proprietà se non sono stati individuati errori. ProprietàCorrente:Parametro predisposto per la gestione MVC utile alla gestione dei metodi di validazione e derivazione dati.Consente la definizione di una variabile stringa in cui viene restituito l'identificativo della proprietà che è stata modificata. Nel caso di validazione complessiva dell'entità la variabile viene restituita a blank. Dalla versione 30.3 il parametro è obsoleto e la proprietà corrente può essere reperita tramite il metodo GetProprietaCorrente(). Per maggiori dettagli sulle modalità di definizione e utilizzo del modello MVC in BC consultare il manuale Guida allo sviluppo in BC, sezione 'La programmazione ad oggetti '. Nel caso di utilizzo di videate composte/multipagina che fanno uso di sorgenti esterni rispetto alla videata contenitore, è necessario fare in modo che le callback di gestione del modello MVC eseguano esclusivamente i metodi di gestione dell'oggetto. In particolare non possono essere eseguite operazioni di accesso alla base dati, strutture dinamiche o aggiornamenti di oggetti video direttamente nella callback locale del sorgente dove è definita la videata.
La validazione di una videata, quindi del suo modello, non si avvia se la videata non è inputabile. In presenza del parametro OUPUT/DISABILITATA, la validazione non viene richiamata.
VALIDAZIONEPARZIALE
GES[cbValidaParziale] IDCONTROLLO[IDControllo] Parametro predisposto per la gestione MVC e correlato al MODELLODATI. La callback contiene i controlli necessari a guidare il caricamento da parte dell'utente. cbValidaParziale: Call-back di richiamo al metodo di validazione parziale del modello dati. La callback viene eseguita al verificarsi di un'azione legata alla navigazione della videata. Gli eventi che vengono notificati sono: ingresso in un tab di un multipagina; pressione di un bottone di toolbar; pressione di un bottone contestuale; esecuzione dell'azione di un menù contestuale; ingresso in una videata (videate composte). All'interno della callback è possibile identificare l'evento che si è verificato tramite la variabile stringa inserita nel sotto-parametro IDCONTROLLO[]. Questa variabile sarà valorizzata con l'identificativo del controllo video verso il quale l'utente ha deciso di spostarsi. Nel caso di un tab o di una videata sarà quindi l'identificativo impostato nel parametro ID[] della '@DEFVID mentre per i bottoni della toolbar è quanto indicato nel parametro IDBOTTONE[] della '@DEFTOOLBAR. Dalla versione 30.6 il parametro è obsoleto e l'id del controllo può essere reperito tramite il metodo GetIdControlloValidazioneParziale().
AZIONEINVIO
[ID[IdControllo]] Permette di definire l'identificativo di un controllo, dal quale, prelevare l'azione ed eseguirla alla pressione del tasto INVIO.
L'utilizzo del parametro implica l'utilizzo del parametro ID
AZIONEINGRESSO
[ID[IdBottone]] Permette di definire l'azione da eseguire all'avvio della videata. L'azione viene eseguita subito dopo aver emesso la videata. Il parametro è utilizzabile esclusivamente nelle videate che prevedono una Ribbon Bar o Toolbar associata. In caso di multipagina, il parametro AZIONEINGRESSO non può essere gestito all'interno delle pagine di dettaglio, ma solo sulla videata ove gestita la definizione del multipagina stesso IdBottone: Identificativo del bottone definito nella Ribbon bar o nella toolbar.
L'utilizzo del parametro implica l'utilizzo del parametro ID
GESTIONEOBBLIGATORI
Permette di definire la logica di gestione dei campi obbligatori da parte dell'ambiente.
-
0 (default): I controlli sui campi obbligatori vengono gestiti dall'ambiente sia in fase di uscita campo che in fase di verifica della videata.
-
1: I controlli sui campi obbligatori vengono gestiti dall'ambiente esclusivamente in uscita dalla videata
-
2: I controlli sui campi obbligatori non vengono gestiti dall'ambiente ma dal programmatore all'interno della routine di validazione (o sotto la runvid). E' comunque necessario definire il parametro OBBLIGATORIO sul campo specifico per evidenziarlo graficamente.
CAMPOCORRENTE
[CampoCorrente] Consente la definizione di una variabile stringa in cui viene restituito il nome della variabile che è stata modificata.
CONTROLLOCORRENTE
E' possibile definire una diversa variabile a video, variabile applicativa, rispetto alla variabile di riferimento, variabile tecnica, per separare fisicamente il comportamento del controllo a video determinato da esigenze applicative rispetto alla variabile tecnica definita sulla base dati.
IDRUNTIME
[VarIdRuntime] Permette di indicare una variabile di programma di tipo stringa (dimensionata di almeno 63 caratteri) che verrà valorizzata con identificatore a runtime della videata. L'identificatore a runtime è calcolato in base allo stack effettivo in cui è stata definita la videata e si differenzia dall'identificatore statico indicato nel parametro ID[]. Questo parametro sostituisce nella pratica l'uso della variabile ZVIDNAME$ dopo la DEFVID. Dalla versione 30.3 di ambiente questo parametro è obsoleto. Utilizzare il parametro NOME e il metodo GetIdRuntime().
RENDER
[TipoRender] Identifica la tipologia di render da utilizzare in fase di presentazione della videata. Il render rappresenta il modo in cui le videate vengono disegnate: WIN9X (vecchie videate), THEMED. La definizione del render avviene con il seguente ordine: 1- CFG (Sistemi, Procedura, Stazione) 2- RENDER (Prodotto, Progetto) 3- Parametro RENDER TipoRender: Può assumere uno dei seguenti valori: <tabella> Sorgente BC Note THEMED La videata viene disegnata con il layout NUOVE VIDEATE WIN9X La videata viene disegnata con il layout VECCHIE VIDEATE </tabella>
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
WIN9X | Vecchie videate |
THEMED | Nuove videate |
CHIUSURAVID
[AzioneChiusura] Call-back richiamata alla chiusura di una videata. A seconda del tipo di videata, il momento del richiamo differisce leggermente:
- se la videata è una videata principale, ossia è stata aperta direttamente dal menù, la callback sarà richiamata al cambio di voce del menù;
- se la videata è un popup, la call-back viene richiamata al click dell'icona di chiusura del popup;
- se la videata è aperta all'interno di un multipagina, la callback è richiamata al campio pagina. Per poter uscire dalla videata quando viene impostato questo parametro, è necessario utilizzare la specifica '@EXITWINDOW.
AGGIORNAPARTIALVIEW
Callback dell'azione da eseguire
AGGIORNADAPARTIALVIEW
Definisce l'azione di callback che viene richiamata quando una partial view all'interno della videata principale viene aggiornata.
CAMBIOPAGINA
[AzioneCambioPagina] Permette di specificare una callback da eseguire al cambio pagina. La callback viene richiamata solo quando la videata si trova all'interno di una videata multipagina e viene eseguito il passaggio su un'altra pagina. La callback non prevede la possibilità di bloccare lo spostamento sulla pagina selezionata dall'utente. GESTIONEOBBLIGATORI - (Input, Opzionale, Default =0) (Disponibile da versione traduttore 25.3) [GestioneCampiObbligatori] Permette di definire la logica di gestione dei campi obbligatori da parte dell'ambiente. TipoRender: Variabile di tipo intero: <tabella> Sorgente BC Note 0 (DEFAULT) I controlli sui campi obbligatori vengono gestiti dall'ambiente sia in fase di uscita campo che in fase di verifica della videata. 1 I controlli sui campi obbligatori vengono gestiti dall'ambiente esclusivamente in uscita dalla videata 2 (MVC) I controlli sui campi obbligatori non vengono gestiti dall'ambiente ma dal programmatore all'interno della routine di validazione (o sotto la runvid). E' comunque necessario definire il parametro OBBLIGATORIO sul campo specifico per evidenziarlo graficamente. </tabella>
FOOTER
Il parametro footer consente di indicare l'ID del template da visualizzare come footer di videata. Il template viene definito con la specifica '@DEFTEMPLATE.
VISTE
COLLEZIONE[CollezioneViste] VISTASELEZIONATA[IdVistaSelezionata] VISTACORRENTE[IdVistaCorrente] AZIONE[AzioneSelezioneVista] AZIONEDETTAGLIO[AzioneDettaglioVista] AZIONEELIMINA[AzioneEliminazioneVista] AZIONEPREFERITO[AzionePreferenzaVista] AZIONENUOVO[AzioneNuovaVista] Parametro predisposto per la gestione delle viste. CollezioneViste: Collezione di tipo BC_VID_VIEW_VOCE che contiene le viste da visualizzare nell'elenco. IdVistaSelezionata: Consente la definizione di una variabile blob in cui viene restituito l'identificativo della vista selezionata. Nel caso di azioni diverse dalla selezione contiene l'id della vista di riferimento, pertanto è necessario mantenere il valore della vista effettivamente selezionata in una variabile del sorgente oppure usare il parametro VISTACORRENTE. IdVistaCorrente: Consente la definizione di una variabile blob in cui viene restituito l'identificativo della vista corrente in riferimento all'azione eseguita sulla vista. AzioneVistaSelezionata: Call-back di richiamo alla gestione della vista. Eseguita ad ogni selezione della vista. AzioneDettaglioVista: Call-back di richiamo alla gestione del dettaglio della vista. Eseguita premendo sull'icona dettaglio di ogni vista. AzioneEliminazioneVista: Call-back di richiamo alla gestione dell'eliminazione della vista. Eseguita premendo sull'icona elimina di ogni vista. AzionePreferenzaVista: Call-back di richiamo alla gestione della preferenza della vista. Eseguita premendo sull'icona preferito di ogni vista. AzioneNuovaVista: Call-back di richiamo alla gestione del creazione di una nuova vista. Eseguita premendo la voce Nuova.
FILTRI
ID[IdBottoneFiltri] AZIONE[AzioneFiltri] EVIDENZIATO[EspEvidenziato] CAMPOFILTRO[COLLEZIONEDATI[NomeCollezione] COLLEZIONESELEZIONATI[NomeCollezioneSelezionati] MULTISEL[FlagSiNo] VAR[VarCampoFiltro] AZIONE[AzioneCampoFiltro] RESETFILTRI[AzioneResetFiltri]] Permette di definire un bottone 'Filtri' automaticamente posizionato sul titolo della videata ed ancorato a destra. IdBottoneFiltri: identificativo del bottone. Azione: L'azione definita viene eseguita premendo il suddetto bottone. EspEvidenziato: espressione BC il cui valore logico determina l'evidenziazione del controllo. NomeCollezione: collezione di tipo BC_DA_VALUE_OPTION degli elementi selezionabili nel campo filtri NomeCollezioneSelezionati: collezione di tipo BC_DA_VALUE_OPTION degli elementi selezionati nel campo filtri Multisel: Determina la differenza tra combo e editmultiselezione VarCampoFiltro: nome della variabile che contiene l'elemento selezionato nel caso di MULTISEL[0]. AzioneCampoFiltro: azione richiamata quando viene modificato il valore del campo filtro. Normalmente, contiene la resetvid della griglia sottostante la filter area della videata in cui campo filtro è contenuto. AzioneResetFiltri: azione nella quale gestire le operazioni di reset dei filtri della filterarea. Se presente l'azione di reset l'ambiente effettua in automatico il reset dei filtri impostati sulle colonne delle griglie presenti nella videata.
RESPONSIVE
Indica se la videata sarà responsive. Default: #false Tramite l'attivazione di questo flag sarà possibile utilizzare tutte le funzionalità responsive dell'ambiente.
FACTBOX
Definisce una FactBox nell’ambiente Web/Responsive, ovvero un riquadro informativo laterale con contenuti dinamici caricati da template e SR gestionali.
Metodi
| Metodo | Descrizione | SMP |
|---|---|---|
| FactboxClose | Chiude la factbox | |
| FactboxOpen | Apre la factbox | |
| GetIdControlloValidazioneParziale | Restituisce l'id del controllo che ha scatenato la validazione parziale | |
| GetIdRuntime | Restituisce l' id runtime della videata | |
| GetOrigineDragDrop | Restituisce l'ID del controllo che ha iniziato l'operazione di drag | |
| GetProprietaCorrente | Restituisce la proprietà corrente, da usare per validazione e derivazione | |
| Rebind | Esegue la riassegnazione del modello dati alla videata (di dettaglio o multipagina) | |
| RefreshParentView | Richiama la callback indicata sul parametro AGGIORNADAPARTILAVIEW della videata che contiene la parziale |