SETFILTERGRIDADV
La funzione '@SETFILTERGRIDADV permette di definire, su una colonna della griglia avanzata, un filtro in visualizzazione. Tali filtri si perderanno, nel momento in cui l'utente li modificherà manualmente, e non verranno più ripristinati finché la videata non verrà chiusa e riaperta.
Parametri
| Parametro | Definizione | I/O | Versione traduttore | SMP | |
|---|---|---|---|---|---|
| NOMEGRIGLIA | Intero | ||||
| COL | Intero | ||||
| VAR | Variabile | ||||
| CRITERIO | Intero | ||||
| VALNUM | Double | ||||
| VALSTRING | Stringa | ||||
| VALDATA | Data | ||||
| VALORI | Stringa | ||||
| FORZA | Intero | ||||
| ERRORE | Intero | ||||
| ID | Stringa | ||||
| ALIAS | Stringa |
NOMEGRIGLIA
Identificativo della griglia.
COL
Indice numerico della colonna su cui si basa la definizione della cella
VAR
Variabile o testo costante associato alla cella
CRITERIO
Criterio applicato al filtro definito sulla colonna
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
1 | Uguale |
2 | In |
3 | Contiene |
4 | Compreso tra |
VALNUM
Valore numerico applicato al filtro sulla colonna di tipo numerico
VALSTRING
Valore di tipo stringa applicato al filtro sulla colonna di tipo testo
VALDATA
Valore data applicato al filtro sulla colonna di tipo data
VALORI
Valore applicato al filtro definito sulla colonna
FORZA
Permette di forzare l'applicazione dei filtri ad ogni aggiornamento della videata
Parametro con valori ammessi, si possono utilizzare i seguenti valori:
| Valore | Descrizione |
|---|---|
0 | L'applicazione del filtro avviene esclusivamente durante la prima definizione della videata. A seguito di successive RESETVID, EXITWINDOW o cicli di riaggiornamento, i filtri non verranno aggiornati |
1 | I filtri vengono aggiornati ogni qual volta si esegua la definizione della videata (DEFVID-RUNVID). L'applicazione dei filtri avverrà con i valori correnti delle variabili assegnate ai relativi parametri |
ERRORE
Consente al programma di intercettare e gestire l'errore restituito dalla funzione.
Utilizzare uno dei metodi GetLastError*() della classe BCContextInfo per ottenere le informazioni dell'errore.
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.
ALIAS
Alias del campo di query da associare alla colonna
Esempi
Applicazione filtro su colonna
'@DEFVID DIM[20,70] TIT["Videata"] ID["IDVideata"]
'@DEFGRIDPANEL NOME[GridPanel] ID["IDGridPanel"] _
RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
RIGA[ALTEZZA[18] LAYOUT[#DINAMICO]] _
RIGA[ALTEZZA[1] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[1] LAYOUT[#FISSO]] _
COLONNA[LUNGHEZZA[68] LAYOUT[#DINAMICO]] _
COLONNA[LUNGHEZZA[1] LAYOUT[#FISSO]]
'@DEFGRIDADV NOME[GridADV] TIT["Griglia avanzata"] ID["IDGridADV"] _
RET[1,1] DIM[1,1] POS[1,1] _
INSRIGHE[InsRighe()] _
GRID[COL[2] RIGA[2] COLDIN[1] RIGADIN[1]]
'@DEFCOLGRIDADV ID["IDColonna"] TIT["Codice"] NOMEGRIGLIA[GridADV] _
LARG[20] VAR[Cod] CELLA[FMT[TESTO]]
'@DEFCOLGRIDADV ID["IDColonna"] TIT["Descrizione"] NOMEGRIGLIA[GridADV] _
LARG[20] VAR[Des] CELLA[FMT[TESTO]]
'@ENDGRIDPANEL NOME[GridPanel]
'@RUNVID
...
'@SRP InsRighe()
'@INSROWGRIDADV NOMEGRIGLIA[GridADV] RIGA[1]
'@INSROWGRIDADV NOMEGRIGLIA[GridADV] RIGA[2]
'@INSROWGRIDADV NOMEGRIGLIA[GridADV] RIGA[3]
Return
...
'@SRP Filtri()
'@SETFILTERGRIDADV NOMEGRIGLIA[GridADV] VAR[Des] VALSTRING["Filtro da applicare"] CRITERIO[1]
Return