DEFGRID
Consente di definire il controllo griglia all'interno di una videata.
Questa griglia si usa solo quando la fonte dati non è omogenea: ci sono formati diversi per le celle nella stessa colonna.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| RECORDCORRENTE | Classe | ||||
| VALIDAZIONEDATI | |||||
| NOME | Intero | ||||
| RET | |||||
| POS | |||||
| DIM | |||||
| ID | Stringa | ||||
| RCFISSE | |||||
| FILE | |||||
| QUERY | Long | ||||
| STRUTTURA | Stringa | ||||
| CARICATUTTO | Intero | ||||
| INSCOL | Azione | ||||
| INSTOTALI | Azione | ||||
| INSRIGHE | Azione | ||||
| LISTA | |||||
| MULTISEL | Intero | ||||
| SELEZIONATUTTO | Intero | ||||
| VARSELEZIONATUTTO | Intero | ||||
| NUMMAXSEL | Intero | ||||
| NUMSEL | Variabile | ||||
| INSRIGA | Azione | ||||
| ADDRIGA | Azione | ||||
| DELRIGA | Azione | ||||
| NOINTESTAZIONECOLONNE | Intero | ||||
| RIGACORRENTE | Variabile | ||||
| COLCORRENTE | Variabile | ||||
| TOTRIGHE | Variabile | ||||
| TOTCOL | Intero | ||||
| SELRIGA | Azione | ||||
| NOTOOLBAR | Intero | ||||
| OUTPUT | Condizione | ||||
| RITORNAVARIABILI | Intero | ||||
| NASCOSTO | Condizione | ||||
| DISABILITATO | Condizione | ||||
| GRIGLIAVUOTA | Azione | ||||
| TIT | Stringa | ||||
| STILETIT | |||||
| TIPOBARRA | Enumerazione | ||||
| NONMODIFICABILE | Intero | ||||
| IDMENU | Stringa | ||||
| REFRESH | Azione | ||||
| CARATTERE | Azione | ||||
| RIDIMENSIONABILE | |||||
| STAMPA | Azione | ||||
| ESPORTASUEXCEL | Intero | ||||
| SPOSTARIGASU | Azione | ||||
| SPOSTARIGAGIU | Azione | ||||
| VISUALIZZATUTTI | Azione | ||||
| VISUALIZZASELEZIONATI | Azione | ||||
| ESPANDITUTTI | Azione | ||||
| COMPRIMITUTTI | Azione | ||||
| SELETTORERIGA | Intero | ||||
| ADATTACOLONNE | Intero | ||||
| DRAG | |||||
| DROP | |||||
| GRID | |||||
| STACK | |||||
| EXPANDER | |||||
| DOCK | |||||
| PERSONALIZZABILE | Intero | ||||
| LINKTO | |||||
| AZIONEINVIO | |||||
| TOOLBAR | |||||
| RIMUOVINUOVARIGA | Intero | ||||
| VALORIZZACOLONNACORRENTE | Intero | 30.4 |
RECORDCORRENTE
Variabile Record valorizzata col contenuto della riga corrente
VALIDAZIONEDATI
Permette di indicare le callback di gestione validazione mediante modello mvc
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.
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.
RCFISSE
Attributo di definizione del numero di righe dall'alto e di colonne da sinistra che devono rimanere fisse durante gli scrolling verticali ed orizzontali
FILE
Attributo che definisce il legame tra la griglia ed un archivio
STRUTTURA
costante o variabile di tipo alfanumerico, indica il nome della struttura. Se costante è da indicare tra i doppi apici
CARICATUTTO
Consente di definire il caricamento di tutte le righe della griglia, evitando la paginazione.
Deve essere utilizzato congiuntamente con l'attributo FILE[].
INSCOL
Attributo per il caricamento delle colonne della griglia
INSTOTALI
Specifica la callBack per definire le righe di totale della griglia
INSRIGHE
Attributo per il caricamento delle righe della griglia
LISTA
Attributo che consente di impostare la modalità 'LISTA'. Se non è indicato la griglia permette l'inserimento dei dati
MULTISEL
Attributo che consente di impostare la selezione multipla delle righe
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
SELEZIONATUTTO
Permette di attivare/disattivare la funzionalità di 'Seleziona tutto' e 'Annulla selezione' della griglia
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
VARSELEZIONATUTTO
Permette di indicare la variabile di programma che conterrà il flag di 'Tutte le righe selezionate'
NUMMAXSEL
Attributo che consente di impostare il numero massimo di elementi selezionabili dalla selezione multipla delle righe
NUMSEL
Attributo che consente di gestire il numero di righe selezionate in caso di selezione multipla
INSRIGA
Attributo che permette l'inserimento di una riga all'interno di una griglia
ADDRIGA
Consente l'aggiunta di una riga al fondo tramite un bottone in toolbar.
Il bottone viene disegnato automaticamente e prende la combinazione di tasti CTRL + +. La pressione ne esegue l'azione indicata nella callback.
- Se la @DEFGRID è in modalità 'Lista' la callback non viene eseguita
- È consentito inserire una o più operazioni semplici utilizzando il carattere ':' come separatore fra le istruzioni.
DELRIGA
Consente l'eliminazione di una riga della griglia tramite un bottone in toolbar.
Il bottone viene disegnato automaticamente e prende la combinazione di tasti CTRL + DEL(CANC).
La pressione ne esegue l'azione indicata nella callback.
- Se la @DEFGRID è in modalità 'Lista' la callback non viene eseguita
- È consentito inserire una o più operazioni semplici utilizzando il carattere ':' come separatore fra le istruzioni.
NOINTESTAZIONECOLONNE
Attributo che consente di eliminare visivamente la riga d'intestazione di tutte le colonne della griglia
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
RIGACORRENTE
Attributo di definizione della variabile contenente il numero di riga corrente
TOTRIGHE
Attributo di definizione della variabile contenente il numero di righe totali
TOTCOL
Attributo di definizione della variabile contenente il numero di colonne totali
NOTOOLBAR
Attributo che consente di non visualizzare la toolbar della griglia per la gestione dei record
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
OUTPUT
Permette di indicare la condizione per rendere in output il controllo.
RITORNAVARIABILI
Indica se ritornare o meno le variabili alla griglia
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
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.
GRIGLIAVUOTA
Attributo per definire un'azione da eseguire nel caso in cui la griglia risulti vuota
TIT
Attributo che simula la creazione di un Groupbox attorno alla griglia mantenendo comunque le dimensioni definite
STILETIT
Attributo di definizione dello stile da applicare al titolo.
Può essere una delle costanti definite in BC per gli stili oppure uno stile precedentemente definito tramite @DEFSTYLE.
TIPOBARRA
Consente di definire la modalità di disegno della barra di selezione delle righe della griglia.
Parametro enumerato, può assumere i seguenti valori:
| Valore | Descrizione |
|---|---|
SOLIDA | La barra di selezione viene disegnata con sfondo pieno |
LEGGERA | La barra di selezione contorna con un bordo tutte le celle della riga corrente |
CELLA | La barra di selezione evidenzia solamente con una bordatura la cella corrente della riga corrente |
AVANZATA | La barra di selezione contorna con un bordo le celle della riga corrente ed inoltre evidenzia ulteriormente con un altro bordo la cella corrente. Corrisponde alla combinazione delle due tipologie LEGGERA e CELLA |
NONMODIFICABILE
Attributo che consente di decidere se impedire a o meno all'utente di personalizzare la griglia
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
IDMENU
Consente di specificare il menù di contesto che verrà associato alle celle della riga.
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ù.
REFRESH
La presenza dell'attributo attiva sulla toolbar della griglia il bottone 'refresh'
CARATTERE
Consente di abilitare la gestione dell'evento 'carattere ricevuto' sulle griglie di lista.
RIDIMENSIONABILE
Attributo che specifica in che modo si vuole ridimensionare la griglia.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
TUTTO | L'oggetto si ridimensionerà sia verso destra che verso il basso |
DESTRA | L'oggetto si ridimensionerà solamente verso destra |
BASSO | L'oggetto si ridimensionerà solamente verso il basso |
NESSUNO | L'oggetto diventerà un oggetto NON ridimensionabile |
STAMPA
Consente di definire il bottone di stampa sulla toolbar della griglia e l'azione da eseguire a fronte della pressione del bottone
ESPORTASUEXCEL
Consente di abilitare o disabilitare la possibilità di esportare il contenuto della griglia su un file Excel.
La toolbar della griglia visualizza un bottone specifico per l'esecuzione dell'esportazione.
L'azione genera un file con il nome <WS>GRI<GR><DATA><ORA>.XLS, nella directory dei file temporanei Windows, che viene visualizzato al termine dell'operazione all'interno di Excel.
L'esportazione gestisce, nel caso di raggruppamento attivo sulla griglia, la creazione di un foglio Excel per ciascun valore di raggruppamento.
Se non indicato la griglia è esportabile, a meno delle impostazioni di disabilitazione della funzionalità, presenti sulla configurazione in esecuzione.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
SPOSTARIGASU
La presenza di quest'attributo visualizza il bottone 'Sposta riga su' sulla toolbar della griglia
SPOSTARIGAGIU
La presenza di quest'attributo visualizza il bottone 'Sposta riga giù' sulla toolbar della griglia
VISUALIZZATUTTI
Visualizza il bottone 'Visualizza tutti' sulla toolbar della griglia.
VISUALIZZASELEZIONATI
Visualizza il bottone 'Visualizza solo selezionati' sulla toolbar della griglia.
ESPANDITUTTI
Visualizza il bottone <Espandi tutti i rami> sulla toolbar della griglia.
La pressione ne esegue l'azione indicata nella callback.
È consentito inserire una o più operazioni semplici utilizzando il carattere ':' come separatore fra le istruzioni.
COMPRIMITUTTI
Visualizza il bottone <Comprimi tutti i rami> sulla toolbar della griglia.
La pressione ne esegue l'azione indicata nella callback.
È consentito inserire una o più operazioni semplici utilizzando il carattere ':' come separatore fra le istruzioni.
SELETTORERIGA
La presenza di quest'attributo permette di visualizzare una colonna aggiuntiva fissa, che identifica (tramite una freccia) la riga attualmente selezionata
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
ADATTACOLONNE
Consente di adattare automaticamente la larghezza delle colonne alla larghezza totale della griglia.
Considera solo le colonne visibili, non fisse e ridimensionabili.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | Adatta colonne disattivo |
1 | Adatta colonne attivo |
DRAG
Consente di definire il comportamento da attenere nel caso in cui venga iniziata un'operazione di drag di Windows (esempio: trascinamento di una riga della griglia).
Consente di indicare:
- Il nome dell'oggetto (identificatore) da associare alle informazioni che vengono trasmesse, in modo che possano essere riconosciute dal controllo/programma di destinazione
- Una callback di programma che permette di specificare le informazioni in base allo stato corrente del controllo (valori della riga corrente della griglia ad esempio), mediante l'impiego della funzione @SETDRAGOBJEC
La funzione definisce la sorgente dati (le informazioni usate nel trascinamento come origine).
La destinazione per un programma BC è definita mediante il parametro DROP.
DROP
Definisce le informazioni necessarie per le operazioni di DROP
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
Consente 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
TOOLBAR
Definizione di una toolbar di azioni gestite da programma
RIMUOVINUOVARIGA
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 |
L'utilizzo del parametro implica l'utilizzo del parametro DELRIGA
VALORIZZACOLONNACORRENTE
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 |
L'utilizzo del parametro implica l'utilizzo del parametro COLCORRENTE