DEFCOLGRIDADV
Consente di definire completamente una colonna della griglia avanzata.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| ID | Stringa | ||||
| NOMEGRIGLIA | Intero | ||||
| VAR | Variabile | ||||
| ALIAS | Stringa | ||||
| LARG | Intero | ||||
| UDMLARG | Stringa | ||||
| TIT | Stringa | ||||
| IMMAGINETIT | Variabile | ||||
| STILETIT | Stringa | ||||
| SOLOICONATIT | Booleano | 32.0 | |||
| LARGDINAMICA | Intero | ||||
| PERCENTUALE | Intero | ||||
| NASCOSTA | Condizione | ||||
| FISSA | Intero | ||||
| NONRIDIMENSIONABILE | Intero | ||||
| COMMENTOTIT | Stringa | ||||
| PERSONALIZZABILE | Intero | ||||
| FILTRI | |||||
| STAMPA | |||||
| GRUPPO | Stringa | ||||
| RAGGRUPPAMENTO | |||||
| AZIONE | Azione | ||||
| NOORDINAMENTO | Intero | ||||
| NORICERCARAPIDA | Intero | ||||
| NOFILTRI | Intero | ||||
| NORIPETIZIONE | Intero | ||||
| VARDISABILITATO | Variabile | ||||
| VAREVIDENZIATO | Variabile | ||||
| VARNASCOSTO | Variabile | ||||
| COMMENTO | Variabile | ||||
| TAGHTML | Intero | ||||
| ESPORTA | Intero | ||||
| LOOKUP | |||||
| FORMULA | 28.5 | ||||
| CELLA | |||||
| IMMAGINE | |||||
| BOTTONE | |||||
| ALBERO | |||||
| FMT | Stringa | ||||
| EXPANDER | |||||
| TEMPLATE | Stringa | ||||
| IDMENU | Stringa | ||||
| NAVIGAZIONE | 28.4 |
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.
VAR
Variabile o testo costante associato alla cella
ALIAS
Serve ad effettuare automaticamente l'associazione della cella (e della sua eventuale variabile indicata in NomeVar) ad un campo della query.
E' possibile utilizzarlo esclusivamente se si sta gestendo una griglia con query come origine dati.
Se specificato il parametro ALIAS, esso prende il posto di VAR come identificativo della colonna in griglia.
Se specificato il parametro ALIAS, esso renderà impossibile l'utilizzo del parametro POSPREDEFINITO[] sulla griglia avanzata.
L'utilizzo del parametro esclude l'utilizzo del parametro LOOKUP
LARG
Attributo di definizione della larghezza della colonna.
UDMLARG
Attributo di definizione dell'unita' di misura della larghezza della colonna
TIT
Titolo da visualizzare come intestazione di colonna
IMMAGINETIT
Nome dell'immagine da associare all'intestazione.
STILETIT
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.
SOLOICONATIT
Indica che l'intestazione della colonna è solo un'icona
LARGDINAMICA
Flag che applica alla colonna il dimensionamento automatico: questo significa che la dimensione della colonna si estenderà in modo da occupare tutto lo spazio all'interno della griglia.
Se presente, il valore numerico indicato per il parametro LARG assume il valore di 'larghezza minima della colonna': la colonna non potrà quindi essere dinamicamente ridotta al di sotto di tale dimensione.
Anche in presenza del parametro LARGDINAMICA, è possibile ridimensionare la colonna: agendo 'manualmente' sulla dimensione: attenzione che si perde però l'effetto dell'adeguamento automatico alla dimensione della griglia. Anche se modificato manualmente, alla ri-esecuzione della videata stessa, l'intervento manuale verrà perso ripristinando il LARGDINAMICA.
PERCENTUALE
Valore che identifica la percentuale di occupazione della colonna all'interno della griglia.
Se presente l'opzione PERCENTUALE le opzioni LARG e LARGDINAMICA risultano inutili.
NASCOSTA
Consente di nascondere la colonna.
FISSA
Si definiscono 'fisse' le colonne che vengono visualizzate permanentemente nella parte sinistra della griglia, e che rimangono visibili durante le operazioni di scrolling sulla videata.
Le colonne fisse sono separate dalle colonne scrollabili da una sottile riga verticale nera. Le colonne fisse sono utilizzabili sia nel caso di griglia in modalità lista, sia nel caso di griglia in modalità di input; in quest'ultimo caso sarà possibile posizionarsi come una qualsiasi cella digitabile.
NONRIDIMENSIONABILE
Indica se la colonna può essere ridimensionata o meno in fase di esecuzione del programma.
COMMENTOTIT
Consente di definire un tip multilinea di commento da associare alla colonna.
Il commento rimarrà visibile per il tempo in cui il mouse punterà sull'intestazione della colonna interessata.
PERSONALIZZABILE
Consente di personalizzare la visualizzazione della colonna, a cura dell'utente.
FILTRI
Consente l'impostazione dei parametri (della colonna) relativi al filtro della colonna
STAMPA
Consente l'impostazione dei parametri (della colonna) relativi alla stampa automatica della griglia avanzata.
GRUPPO
Indica la descrizione dell'eventuale gruppo di colonne di appartenenza (intestazione multipla). Le colonne adiacenti aventi questo parametro impostato con lo stesso valore verranno raggruppate sotto una multipla intestazione comune.
Da BC/X v.22.1 è possibile gestire più gruppi di intestazione (multilivello). Per inserire più livelli è necessario cominciare da quello inferiore e separarli utilizzando il carattere '|'.
Ad es: GRUPPO['LIV1|LIV2|LIV3'].
Invece, se una colonna non ha il primo livello, ma solo il secondo e il terzo, la definizione sarà: GRUPPO['|LIV2|LIV3']
RAGGRUPPAMENTO
Permette di impostare i parametri del raggruppamento derivato dalla colonna che si sta definendo.
AZIONE
Azione collegata alla pressione della cella, del bottone, dell'immagine o dell'azione predefinita del AZIONEMENU.
NOORDINAMENTO
Consente la disattivazione dell'ordinamento automatico sulla colonna.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
NORICERCARAPIDA
Consente la disattivazione della ricerca rapida sulla colonna.
In ambiente Web non ha significato.
In ambiente Mobile permette di escludere la cella tra quelle considerate per la creazione automatica dei filtri
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | visualizza bottone di ricerca rapida |
1 | nasconde il bottone di ricerca rapida |
NOFILTRI
Consente di eliminare la possibilità, di applicare o meno un filtro in visualizzazione su tutte le colonne della griglia.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | Visualizza bottone di attivazione dei filtri in visualizzazione sulle colonne |
1 | Nasconde il bottone di attivazione dei filtri in visualizzazione sulle colonne |
NORIPETIZIONE
Vieta di ripetere il dato della colonna.
VARDISABILITATO
Variabile che gestisce la disabilitazione dell'azione (hyperlink) sulla griglia avanzata
VAREVIDENZIATO
Variabile che gestisce l'evidenziazione della cella (viene applicato un triangolino in alto a destra)
VARNASCOSTO
Variabile che gestisce la visualizzazione del testo sulla griglia avanzata
COMMENTO
Consente di associare alla cella un commento.
Se sulla cella è utilizzato il parametro ALIAS, anche sul parametro COMMENTO va utilizzato il parametro ALIAS.
TAGHTML
Permette di indicare che il testo nelle celle utilizza tag HTML per la formattazione.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | il testo non contiene tag HTML |
1 | il testo contiene tag HTML |
ESPORTA
Consente di stabilire se esportare o meno la colonna.
Di default una colonna viene esportata se è visibile e non esportata se è nascosta e personalizzabile.
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | No |
1 | Si |
LOOKUP
Permette di creare una colonna di lookup, cioè una colonna estratta dauna query indipendente, rispetto all'estrazione dati, la cui esecuzione avviene su un thread separato.
Il parametro è incompatibile col parametro VAR
FORMULA
Permette di definire una colonna calcolata il cui valore è il risultato di operazioni con altre colonne della griglia o costanti.
CELLA
Permette di impostare i parametri specifici per le colonne di tipo testuale.
IMMAGINE
Permette di impostare i parametri specifici per le colonne di tipo immagine.
BOTTONE
Permette di impostare i parametri specifici per le colonne di tipo pulsante.
ALBERO
Permette di impostare i parametri specifici per le colonne di tipo albero.
FMT
Consente di definire il formato del testo visualizzato nella cella.
Questo parametro è obbligatorio per un testo variabile mentre può essere omesso nel caso di testo costante. In questo caso il formato sarà 'TESTO' ed il numero ci caratteri viene determinato direttamente dal testo.
EXPANDER
Attached Property per pannello di tipo Expander
TEMPLATE
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.
IDMENU
Consente di specificare l'identificativo univoco del menù di contesto che verrà associato alle celle della riga. Deve essere definito in precedenza mediante una specifica '@DEFCONTEXTDYN.
NAVIGAZIONE
Gestisce la navigazione in drill - down a partire dalla colonna
Esempi
Definizione colonna ad albero
'@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata"]
'@DEFGRIDPANEL NOME[GridPanel1] ID["IDGridPanel1"] _
RIGA[ALTEZZA[20] LAYOUT[#DINAMICO]] _
COLONNA[LUNGHEZZA[70] LAYOUT[#DINAMICO]]
'@DEFGRIDADV ID["GrigliaAdv1"] NOME[GrigliaAvanzata1] POS[1,1] RET[1,1] INSRIGHE[InsRighe()] _
GRID[COL[1] RIGA[1] RIGADIN[1] COLDIN[1]]
'Definizione colonna della griglia con parametro 'ALBERO'
'@DEFCOLGRIDADV ID["ColonnaAlberata"] NOMEGRIGLIA[GrigliaAvanzata1] VAR[variabile] LARG[20] _
ALBERO[ESPANDI[Espandi()] FMT[TESTO]]
'@ENDGRIDPANEL NOME[GridPanel1]
'@RUNVID
Definizione colonna con immagine
'@DEFRESOURCE NOMERISORSA["Immagine.PNG"]
'@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata"]
'@DEFGRIDPANEL NOME[GridPanel2] ID["IDGridPanel2"] _
RIGA[ALTEZZA[20] LAYOUT[#DINAMICO]] _
COLONNA[LUNGHEZZA[70] LAYOUT[#DINAMICO]]
'@DEFGRIDADV ID["GrigliaAdv2"] NOME[GrigliaAvanzata2] POS[1,1] RET[1,1] INSRIGHE[InsRighe()] _
GRID[COL[1] RIGA[1] RIGADIN[1] COLDIN[1]]
'Definizione colonna della griglia con parametro 'IMMAGINE'
'@DEFCOLGRIDADV ID["ColonnaImmagine"] NOMEGRIGLIA[GrigliaAvanzata2] VAR[variabile] LARG[20] _
IMMAGINE[VALORIAMMESSI[VAL["Valore ammesso"] IMMAGINE["Immagine.PNG"] OPZIONE["Descrizione valore ammesso"]]]
'@ENDGRIDPANEL NOME[GridPanel2]
'@RUNVID
Definizione colonna con bottone
'@DEFRESOURCE NOMERISORSA["Immagine.PNG"]
'@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata"]
'@DEFGRIDPANEL NOME[GridPanel3] ID["IDGridPanel3"] _
RIGA[ALTEZZA[20] LAYOUT[#DINAMICO]] _
COLONNA[LUNGHEZZA[70] LAYOUT[#DINAMICO]]
'@DEFGRIDADV ID["GrigliaAdv3"] NOME[GrigliaAvanzata3] POS[1,1] RET[1,1] INSRIGHE[InsRighe()] _
GRID[COL[1] RIGA[1] RIGADIN[1] COLDIN[1]]
'Definizione colonna della griglia con bottone a destra
'@DEFCOLGRIDADV ID["ColonnaBottone"] NOMEGRIGLIA[GrigliaAvanzata3] VAR[variabile] LARG[20] _
BOTTONE[IMMAGINE["Immagine.PNG"] POSIMMAGINE[#DESTRA]]
'@ENDGRIDPANEL NOME[GridPanel3]
'@RUNVID
Definizione colonna con cella
'@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata"]
'@DEFGRIDPANEL NOME[GridPanel4] ID["IDGridPanel4"] _
RIGA[ALTEZZA[20] LAYOUT[#DINAMICO]] _
COLONNA[LUNGHEZZA[70] LAYOUT[#DINAMICO]]
'@DEFGRIDADV ID["GrigliaAdv4"] NOME[GrigliaAvanzata4] POS[1,1] RET[1,1] INSRIGHE[InsRighe()] _
GRID[COL[1] RIGA[1] RIGADIN[1] COLDIN[1]]
'Definizione colonna della griglia con parametro 'CELLA'
'@DEFCOLGRIDADV ID["ColonnaBottone"] NOMEGRIGLIA[GrigliaAvanzata4] VAR[variabile] LARG[20] _
CELLA[FMT[TESTO] VALORIAMMESSI[VAL["Valore ammesso"] OPZIONE["Descrizione valore ammesso"]]]
'@ENDGRIDPANEL NOME[GridPanel4]
'@RUNVID