Navigation:  I Viewer: esposizione dei dati > Il Viewer Grid > Le Property di una Grid > Esempi di Band Property > I raggruppamenti di una Band

Nella finestra di esecuzione del Book associato, una Grid dispone di alcune funzionalità per l'analisi a posteriori del risultato ottenuto, tra le quali il raggruppamento dei record per colonna. Il pulsante Group by del gruppo Grid del Ribbon, se attivo, crea un'area al di sopra della Grid dove trascinare, mediante drag & drop, i campi rispetto ai quali raggruppare i dati delle Band sottostanti.

 

 

È possibile abilitare/disabilitare il raggruppamento dei record per colonna a livello di Band, mediante la Band Property, della classe Overrride, AllowGroupBy. Essa può assumere i valori:

✓ True abilita il raggruppamento rispetto a qualsiasi colonna della Band;

✓ False inibisce il raggruppamento rispetto a qualsiasi colonna della Band;

✓ Default coincide con True.

 

Il raggruppamento per colonne può essere specializzato a livello delle singole colonne componenti la Band, mediante la Column Property AllowGroupBy. Essa assume gli stessi valori dell'omonima Band Property, ma permette di differenziare il comportamento colonna per colonna.

 

 

Lo stile grafico dei raggruppamenti per colonna, visualizzati nella finestra di esecuzione, può essere personalizzato mediante le seguenti Band Property della classe Overrride:

✓ GroupByRowAppearance consente di personalizzare l’aspetto grafico delle intestazioni dei raggruppamenti;

✓ GroupByRowDescriptionMask permette di personalizzare il testo visualizzato nelle intestazioni dei raggruppamenti;

✓ GroupByRowInitialExpansionState imposta il tipo di visualizzazione iniziale dei raggruppamenti;

✓ GroupByRowExpansionStyle definisce la modalità con cui espandere a video i raggruppamenti;

✓ GroupByRowConnectorAppearance consente di personalizzare l’aspetto grafico della striscia verticale, a sinistra dei record, che identifica i singoli gruppi;

✓ GroupByRowPadding imposta lo spazio in pixel intorno alle intestazioni dei gruppi;

✓ GroupByRowSpacingAfter definisce lo spazio in pixel tra l'intestazione di un gruppo ed il gruppo stesso;

✓ GroupByRowSpacingBefore definisce lo spazio in pixel tra un gruppo e l'intestazione del gruppo successivo.

 

Il valore di default della proprietà GroupByRowDescriptionMask assume la forma [caption]:[value]([count]) dove

✓ [caption] indica il nome della colonna rispetto alla quale si effettua il raggruppamento;

✓ [value] rappresenta il valore che identifica il gruppo sottostante;

✓ [count] espone il numero di record visibili nel gruppo sottostante.

 

La proprietà GroupByRowInitialExpansionState può assumere i valori:

✓ Collapsed mostra, all'apertura del Book, le sole intestazioni dei gruppi;

✓ Expanded mostra, all'apertura del Book, intestazioni e record componenti i singoli gruppi;

✓ Default coincide con Collapsed.

 

La proprietà GroupByRowExpansionStyle può assumere i valori:

✓ ExpansionIndicator abilita l’espansione dei singoli gruppi mediante l’apposito pulsante a sinistra delle intestazioni;

✓ DoubleClick abilita l’espansione dei singoli gruppi mediante doppio click sull’intestazione dei gruppi;

✓ ExpansionIndicatorAndDoubleClick combina ExpansionIndicator e DoubleClick;

✓ Disabled disabilita l’espansione dei gruppi;

✓ Default coincide con ExpansionIndicatorAndDoubleClick.

 

 

È anche possibile intervenire sull'aspetto dei campi rispetto ai quali è stato effettuato il raggruppamento, mediante le seguenti Band Property della classe Overrride:

✓ GroupByColumnsHidden mostra/nasconde nella Band corrente le colonne utilizzate per i raggruppamenti;

✓ GroupByColumnAppearance definisce uno stile grafico per le celle delle colonne utilizzate per i raggruppamenti;

✓ GroupByColumnHeaderAppearance definisce uno stile grafico per le intestazioni delle colonne utilizzate per i raggruppamenti.

 

La proprietà GroupByColumnsHidden può assumere i valori:

✓ True nasconde nella Band corrente i campi su cui si basano i raggruppamenti;

✓ False mostra nella Band corrente i campi su cui si basano i raggruppamenti;

✓ Default coincide con True.

 

Oltre al raggruppamento dei record per colonna, è possibile anche definire gruppi di intestazioni di colonne, mediante la Band Property Groups. Essa consente di accedere ad un editor dedicato alla definizione di questi particolari tipi di gruppo.

Il Groups Editor si compone dei seguenti riquadri:

✓ un riquadro esponente l'elenco dei gruppi di colonne disponibili;

✓ un riquadro di proprietà grafiche impostabili sulle colonne del gruppo attualmente selezionato nell'elenco;

✓ un riquadro esponente le colonne disponibili nella Band corrente;

✓ un riquadro esponente le colonne componenti il gruppo attualmente selezionato nell'elenco.

Il pulsante consente di spostare colonne dal riquadro Available Columns al riquadro Columns in Group. Viceversa, i pulsanti , e consentono, rispettivamente, di ordinare ed eliminare le colonne esposte nel riquadro Columns in Group.

Infine i pulsanti , e nella toolbar dell'editor consentono, rispettivamente, di:

✓ aggiungere un nuovo gruppo di colonne;

✓ rimuovere un gruppo di colonne dall'elenco;

✓ chiudere l'editor salvando le modifiche apportate.