DEFINPUTGRIDADV
La specifica è deprecata a partire dalla versione 31.2
Al suo posto vedere specifica DEFCOLLECTIONGRID
Consente di definire il controllo griglia di input avanzata all'interno di una videata.
La fonte dati della griglia è la collezione di oggetti specificata nel parametro COLLEZIONEDATI. Dalla classe di riferimento della collezione dati viene derivata la definizione delle colonne ed il numero di righe da visualizzare.
Una qualsiasi modifica ai dati contenuti nella collezione si riflette automaticamente sul controllo video senza necessità di alcun tipo di ulteriori operazioni.
I metodi sono richiamabili nella callback specificata nel parametro ONLOAD della @DEFVID per le impostazioni della prima visualizzazione oppure in una qualsiasi azione per modificare le impostazioni in un secondo momento.
- Nel caso di operazioni massive è possibile sospendere l'aggiornamento video utilizzando la specifica @SUSPENDVIDREFRESH.
- La definizione delle colonne può essere ulteriormente specializzata attraverso il parametro COLLEZIONECOLONNE popolando la collezione d'ambiente di tipo BC_VID_GRID_COL.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| NOME | Intero | ||||
| RET | |||||
| POS | |||||
| DIM | |||||
| OGGETTOCORRENTE | Classe | ||||
| ID | Stringa | ||||
| COLLEZIONEDATI | Collezione | ||||
| COLLEZIONECOLONNE | Collezione di classi | ||||
| TOOLBAR | |||||
| INIZIALIZZAZIONE | Azione | ||||
| RICERCA | Azione | ||||
| INRIGA | Azione | ||||
| OUTRIGA | Azione | ||||
| AZIONECLICK | Azione | ||||
| IDMENU | Stringa | ||||
| DRAG | 29.0 | ||||
| DROP | 29.0 | ||||
| COMPRIMIRAGGRUPPAMENTI | 29.0 | ||||
| PREVALIDAZIONE | Azione | ||||
| POSTDERIVAZIONEDATI | Azione | ||||
| VALIDAZIONEDATI | |||||
| MULTISELEZIONE | 28.4 | ||||
| GRID | |||||
| STACK | |||||
| EXPANDER | |||||
| DOCK | |||||
| PERSONALIZZABILE | Intero | ||||
| LINKTO | |||||
| AZIONEINVIO | |||||
| BLOCCALOOKUP | Booleano | 29.5 |
RET
Coordinate della cella del reticolo da associare al controllo.
Queste informazioni hanno lo scopo di inserire il controllo nella logica di gestione degli spostamenti sulla videata.
POS
Posizionamento del controllo.
Consente di indicare la riga e la colonna. Per entrambi è possibile specificare l'unità di misura.
POS[RigaVid [UnitàMisura], ColonnaVid [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.
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.
OGGETTOCORRENTE
Attributo di definizione della variabile contenente il riferimento all'oggetto corrente.
L'oggetto indicato viene valorizzato nel momento in cui una riga della griglia prende il fuoco ed quindi disponibile per tutte le callback di gestione della griglia stessa.
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.
COLLEZIONEDATI
Definizione del legame tra la griglia ed una collezione di dati precedentemente definita.
In questo modo si crea un'associazione a due vie tra griglia e collezione. Questo permette di avere la griglia aggiornata automaticamente ad ogni modifica sulla collezione e la collezione aggiornata automaticamente ad ogni modifica in griglia.
COLLEZIONECOLONNE
Definizione delle colonne della griglia, specializzandole rispetto alla classe di riferimento della collezione dati associata alla griglia.
Deve essere una collezione di oggetti della classe BC_VID_GRID_COL.
TOOLBAR
Identificativo della toolbar di videata, definita precedentemente tramite specifica @DEFTOOLBAR.
INIZIALIZZAZIONE
Callback per l'inizializzazione di un nuovo oggetto nella collezione dati. Viene richiamata a seguito dell'aggiunta automatica della riga alla pressione del tab sull'ultima cella dell'ultima riga presente in griglia.
RICERCA
Callback per il richiamo della funzione di ricerca delle celle della griglia.
La callback è unica ed al suo interno è possibile identificare la cella dalla quale è stata richiesta la ricerca attraverso il parametro PROPRIETACORRENTE della @DEFVID.
INRIGA
Callback per la definizione delle operazioni da eseguire in ingresso riga.
Non è possibile inserire in tale parametro le istruzioni 'GOTO' mentre è consentito inserire una o più operazioni semplici (assegnamenti) utilizzando il carattere ':' come separatore fra le istruzioni.
OUTRIGA
Callback per la definizione delle operazioni da eseguire in uscita riga.
Non è possibile inserire in tale parametro le istruzioni 'GOTO' mentre è consentito inserire una o più operazioni semplici (assegnamenti) utilizzando il carattere ':' come separatore fra le istruzioni.
- Nello sviluppo in cui viene gestita una architettura MVC la callback di OUTRIGA viene chiamata dopo le callback di VALIDAZIONEDATI/DERIVAZIONEDATI, solo se non ci sono stati errori.
- L'ambiente di esecuzione esegue la validazione all'uscita di ogni cella mettendo a disposizione il nome della proprietà (la singola cella), grazie al parametro PROPRIETACORRENTE indicato sulla specifica @DEFVID, ed esegue la validazione anche all'uscita della riga.
IDMENU
Menu contestuale da visualizzare attraverso il tasto destro sulla griglia.
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ù.
DRAG
Consente di definire il comportamento da attenere nel caso in cui venga iniziata un'operazione di trascinamento di una riga della griglia.
DROP
Consente di definire il comportamento da attenere nel caso in cui venga terminata un'operazione di trascinamento all'interno della griglia.
COMPRIMIRAGGRUPPAMENTI
Consente di definire la modalità di visualizzazione del raggruppamento eventualmente definito per la griglia mediante il parametro RAGPREDEFINITO
PREVALIDAZIONE
Callback richiamata prima del processo di VALIDAZIONE.
All'interno della callback è possibile gestibile la specifica @BREAKEVENT per poter bloccare tutto il flusso di validazione dei dati.
POSTDERIVAZIONEDATI
Callback richiamata dopo la DERIVAZIONEDATI, per effettuare aggiornamenti grafici ulteriori.
VALIDAZIONEDATI
Definisce i metodi per la validazione e derivazione dei dati modificati sull'oggetto a cui la videata fa riferimento.
MULTISELEZIONE
Permette di indicare le callback di gestione della multiselezione delle righe della griglia
EXPANDER
Attached Property per pannello di tipo Expander
DOCK
Consente di indicare se l'oggetto deve occupare tutto lo spazio del DockPanel in verticale e/o in orizzontale (possono essere indicati entrambi).
PERSONALIZZABILE
Definisce l'oggetto grafico come personalizzabile dall'utente in fase di runtime.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
LINKTO
Permette di creare un legame tra due controlli esistenti all'interno della stessa videata.
AZIONEINVIO
Consente di indicare l'ID del tasto da simulare alla pressione del tasto INVIO.
L'utilizzo del parametro implica l'utilizzo del parametro ID
BLOCCALOOKUP
Definisce la possibilità di bloccare la definizione di colonne di lookup personalizzate in presenza di colonne dinamiche.
In questo modo si evita che, graficamente, alcune colonne dinamiche possano essere mostrate in un ordine errato qualora sia presente una o più colonne personalizzate di lookup.
Metodi
| Metodo | Descrizione | SMP |
|---|---|---|
| AdattaRiga | Adatta l'altezza della riga al testo contenuto nelle colonne multilinea | |
| AdattaRighe | Adatta l'altezza di tutte le righe della griglia all'avvio | |
| AggiornaRigheModificate | Aggiorna le righe modificate sulla collezione | |
| BloccaOrdinamentoDati | Blocco delll'ordinamento dei dati della griglia | |
| CaricaValoriIdentificazione | Carica una collezione contenente i valori identificativi delle righe | |
| ComprimiTuttiGruppi | Comprime/espande tutti i raggruppamenti della griglia | |
| ComprimiTuttiNodi | Comprime/espande tutti i nodi della griglia | |
| DisabilitaSelezionaTutto | Disabilita la funzionalità di 'Seleziona tutto' e 'Annulla selezione' della griglia | |
| GetColonnaCorrente | Restituisce l'identificativo della colonna con il fuoco | |
| GetLivelloAlbero | Restituisce il livello gerarchico del nodo dell'albero | |
| GetNumeroRighe | Restituisce il numero di righe della griglia | |
| GetStatoNodo | Restituisce lo stato di visibilità di un nodo della griglia | |
| GetValoreCellaCorrente | Restituisce il valore contenuto all'interno della cella corrente | |
| GetValoriIdentificazione | Restituisce una stringa contenente i valori identificativi della riga corrente | |
| InserisciRiga | Inserisce una riga all'interno della griglia | |
| Rebind | Permette di modificare, a runtime, la fonte dati della griglia | |
| RigaEliminabileAutomaticamente | Restituisce se la riga corrente verrà eliminata automaticamente o meno | |
| SetAggiuntaRigaAuto | Abilitazione/Disabilitazione aggiunta automatica di una riga alla pressione del tasto TAB | |
| SetEditabile | Abilitazione/Disabilitazione griglia | |
| SetMultiselezione | Abilitazione/Disabilitazione multiselezione in griglia | |
| SetNoRipetizione | Permette di evitare la ripetizione degli stessi valori delle celle tra una riga e l'altra | |
| SetOrdinamento | Permette di impostare un ordinamento sulla griglia | |
| SetPosizionamento | Permette di definire una condizione per calcolare il posizionamento del cursore sulla griglia | |
| SetQueryAutocompletamento | Permette di ridefinire, a runtime, la query di autocompletamento di una colonna | |
| SetQueryObjectAutocompletamento | Imposta una query di autocompletamento sulla colonna sostituendo quella già presente | |
| SetRaggruppamentoComposto | Permette di impostare un raggruppamento composto sulla griglia | |
| SetRaggruppamentoRighe | Permette di impostare un raggruppamento sulla griglia | |
| SetRimuoviRigaVuota | Abilitazione/Disabilitazione eliminazione di una riga automaticamente in fase di uscita dalla riga | |
| SetStampa | Abilitazione/Disabilitazione stampa della griglia | |
| SetStampaAdattaPagina | Permette di impostare, a runtime, se nella stampa la griglia deve essere adattata alla pagina di stampa | |
| SetStampaSottotitolo | Permette di cambiare, a runtime, il sottotitolo della pagina di stampa | |
| SetStampaTitolo | Permette di cambiare, a runtime, il titolo della pagina di stampa | |
| SetStatoOutput | Permette di impostare, a runtime, lo stato di output di una colonna della griglia | |
| SetStatoVisibilita | Permette di impostare, a runtime, lo stato di visibilità di una colonna della griglia | |
| SetStileRiga | Permette di definire una formula per calcolare lo stile da applicare ad ogni riga della griglia | |
| SetTitolo | Permette di cambiare, a runtime, il titolo di una colonna della griglia | |
| Stampa | Permette di effettuare la stampa della griglia direttamente da codice |