Passa al contenuto principale

SETFILTERGRIDADV

28.1DesktopWebMobileResponsive

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

ParametroDefinizioneI/OInformazioniVersione traduttoreSMP
NOMEGRIGLIAInteroINObbligatorioDesktopWebMobileResponsive
COLInteroINDesktop
VARVariabileINDesktopWebMobileResponsive
CRITERIOInteroINObbligatorioDesktopWebMobileResponsive
VALNUMDoubleINDesktopWebMobileResponsive
VALSTRINGStringaINDesktopWebMobileResponsive
VALDATADataINDesktopWebMobileResponsive
VALORIStringaINDesktopWebMobileResponsive
FORZAInteroINDesktop
ERROREInteroINDesktopWebMobileResponsive
IDStringaINWebMobileResponsive
ALIASStringaINWebMobileResponsive

NOMEGRIGLIA

InteroINInputObbligatorioObbligatorioValore non necessarioValore non necessarioDesktopWebMobileResponsive

Identificativo della griglia.

COL

InteroINInputValore non necessarioValore non necessarioDesktop

Indice numerico della colonna su cui si basa la definizione della cella

VAR

VariabileINInputValore non necessarioValore non necessarioDesktopWebMobileResponsive

Variabile o testo costante associato alla cella

CRITERIO

InteroINInputObbligatorioObbligatorioValore non necessarioValore non necessarioDesktopWebMobileResponsive

Criterio applicato al filtro definito sulla colonna

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

ValoreDescrizione
1Uguale
2In
3Contiene
4Compreso tra

VALNUM

DoubleINInputValore non necessarioValore non necessarioDesktopWebMobileResponsive

Valore numerico applicato al filtro sulla colonna di tipo numerico

VALSTRING

StringaINInputValore non necessarioValore non necessarioDesktopWebMobileResponsive

Valore di tipo stringa applicato al filtro sulla colonna di tipo testo

VALDATA

DataINInputValore non necessarioValore non necessarioDesktopWebMobileResponsive

Valore data applicato al filtro sulla colonna di tipo data

VALORI

StringaINInputValore non necessarioValore non necessarioDesktopWebMobileResponsive

Valore applicato al filtro definito sulla colonna

FORZA

InteroINInputValore non necessarioValore non necessarioDesktop

Permette di forzare l'applicazione dei filtri ad ogni aggiornamento della videata

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

ValoreDescrizione
0L'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
1I 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

InteroINInputValore non necessarioValore non necessarioDesktopWebMobileResponsive
SottoParametri

Consente al programma di intercettare e gestire l'errore restituito dalla funzione.

suggerimento

Utilizzare uno dei metodi GetLastError*() della classe BCContextInfo per ottenere le informazioni dell'errore.

ID

StringaINInputValore non necessarioValore non necessarioWebMobileResponsive

Definisce la variabile o la costante di programma che contiene l'identificatore univoco del controllo.

note

Viene utilizzato dall'ambiente per gestire le personalizzazioni effettuate durante l'esecuzione del programma.

ALIAS

StringaINInputValore non necessarioValore non necessarioWebMobileResponsive

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