ErgoDataGrid
manuale d' uso
1. Navigazione delle pagine
2. Filtraggio delle righe visualizzate
3. Scelte prestabilite per il filtro e l' ordinamento
4. Aggiornamento dei dati in tempo reale
5. Ordinamento delle righe visualizzate
6. Modalità di filtro, numero di pagina, numero di record per ogni pagina, lingua di funzionamento
7. Link e tooltip
8. Evidenziazione delle righe
9. Ridimensionamento delle colonne
1. Navigazione delle pagine
Ergodatagrid principalmente è una griglia dati con molte funzionalità delegate ai bottoni della sua toolbar.
I bottoni 
,
,
,
se presenti, indicano che i dati sono organizzati in pagine: consentono di vedere la prima pagina, la precedente, la successiva e l' ultima pagina di record.
2. Filtraggio delle righe visualizzate
Il pulsante 
fa comparire la riga del filtro, che dà la possibilità di impostare le regole per selezionare quali record visualizzare.
Questa riga contiene delle caselle di testo in corrispondenza di ognuna delle colonne della griglia.
E' possibile posizionare il cursore sopra di ognuna di esse e cambiarne il valore: il loro contenuto è la regola per la visualizzazione relativa alla colonna corrispondente.
Per cambiare il criterio con cui viene considerato il loro valore, che per default è il criterio uguale a, dovete fare doppio-click sopra di esse e scegliere una delle opzioni (fino a 18) del pop-up che appare.
I campi della griglia di tipo booleano hanno una casella-filtro su cui non è possibile inserire alcun valore: si può fare doppio-click sopra di essa e impostare l' attributo vero o falso, oppure usare il metodo illustrato di seguito, valido per tutti i possibili tipi di dato.
Oltre che posizionarsi sulla casella-filtro e digitare il valore, è possibile cliccare sui campi della griglia: il valore corrispondente viene portato nella relativa casella di testo del filtro.
Per i campi della griglia che riportano una data, il valore del filtro segue le facilitazioni adottate per il filtraggio in base ai campi con le date; inoltre, la griglia può essere impostata in modo che il formato delle date sia friendly per la visualizzazione ma compaia un valore corretto sulla casella del filtro cliccandoci come indicato sopra.
Con il tasto 
si attiva il filtro: le righe visualizzate sono quelle a cui corrispondono le regole del filtro.
Il tasto 
annulla il filtro fatto eseguire in precedenza.
Il tasto 
cancella i valori immessi nelle caselle-filtro e i criteri che sono stati cambiati tornano al default (uguale a).
3. Scelte prestabilite per il filtro e l' ordinamento
Il bottone
, se presente, fa apparire una finestra in cui ci sono delle possibilità prestabilite per impostare il filtro e l' ordinamento dei record.
4. Aggiornamento dei dati in tempo reale
Con il tasto 
, quando presente, la griglia viene aggiornata: i suoi dati vengono richiesti nuovamente al server; una volta premuto, il bottone passa dallo stato disabilitato a quello abilitato: questo passaggio indica che il trasferimento dei record è terminato con successo.
5. Ordinamento delle righe visualizzate
L' ordinamento dei record viene eseguito in due modi, più quello dato dalle possiblità prestabilite:
- con il tasto sinistro del mouse sopra l' intestazione di ogni colonna, la griglia sarà ordinata solamente per il campo associato a quella colonna, in modo ascendente se compare la freccia verso l' alto (al primo click), in modo discendente se compare la freccia verso il basso (al click successivo);
- con il tasto sinistro + CTRL, la griglia è ordinata in modo principale per la colonna su cui già compare una delle freccie in basso o in alto senza nessun numero vicino, e poi per la colonna su cui ho fatto click, nel modo ascendente o discendente uguale a quello spiegato per la pressione del tasto sinistro, con un numero vicino che indica la sua progressiva importanza per l' ordinamento: questa volta se clicco ulteriormente per la terza volta la colonna viene esclusa dalle regole di ordinamento.
Tutte le colonne della griglia possono essere aggiunte a questo ordinamento multi-campo, cliccando la prima volta con il tasto sinistro e successivamente con quello destro.
6. Modalità di filtro, numero di pagina, numero di record per ogni pagina, lingua di funzionamento
Alla destra della toolbar di ErgoDataGrid possono esserci delle opzioni di funzionamento, alcune opzionali, che sono:
la scelta della modalità di filtro, che può essere AND (tutti i criteri formano il filtro) oppure OR (almeno uno dei criteri forma il filtro);
il numero di pagina dei record visualizzati può essere scelto, oltre che dai pulsanti della toolbar di ErgoDataGrid, anche da una combo-box con l' elenco delle pagine-dato su cui navigare;
una pulsante con una casella di testo vicina e l' etichetta Top:
il valore inserito nella casella dice quanti record visualizzare ad ogni pagina-dati della griglia;
se scrivo 0 i bottoni per le pagine-dati scompaiono e tutti i record vengono visualizzati;
per stabilire quanti record visualizzare bisogna premere su Imposta;
la lingua di funzionamento può essere stabilita scegliendo una delle opzioni della combo-box con l' etichetta Lang.
7. Link e tooltip
Nel corpo della griglia possono essere presenti dei campi con un link associato, su cui cliccando succede qualcosa di diverso per ogni situazione, o possono apparire sopra ai campi valore dei tooltip con spiegazioni, suggerimenti o dati aggiuntivi.
Il tooltip di default che appare sopra a tutte le righe indica che numero di riga è quella su cui è posizionato il mouse, quante righe ci sono in totale, e quante righe sono state filtrate dopo la pressione del tasto .
8. Evidenziazione delle righe
Se clicco sopra ad una delle righe quando il cursore non indica che mi trovo sopra ad un link, la riga viene evidenziata: posso evidenziare righe a piacimento, che rimangono evidenziate anche dopo il cambiamento della pagina-dati; cliccando una seconda volta la riga viene de-evidenziata.
9. Ridimensionamento delle colonne
Posizionando il mouse sopra ai bordi verticali dell' intestazione di ogni colonna e spostandolo a destra o a sinistra tenendo premuto il tasto sinistro regolo la larghezza della colonna corrispondente: se succesivamente faccio doppio click sul bordo verticale, la larghezza torna quella dell' origine.