Scopo
La proprietà GroupLevel indica il livello di raggruppamento di questa sezione all'interno del report: la prima sezione di gruppo del report ha GroupLevel uguale ad uno, il gruppo immediatamente più interno ha GroupLevel uguale a 2 e così via.
Sintassi
int lev = 0 // Livello di raggruppamento della sezione
//
lev := Sezione.GroupLevel
//
lev := Sezione.GroupLevel
Quando letta
Ritorna un numero intero che indica a quale livello di raggruppamento si trova la sezione. Tale proprietà restituisce un valore diverso da zero solo per le sezioni di tipo GroupHeader e GroupFooter.
Quando impostata
Indica al sistema quale deve essere il nuovo livello di raggruppamento al quale deve essere spostata la sezione. Il nuovo valore deve essere compreso tra 1 ed il numero di gruppi definiti a design time (estremi inclusi).
Esempio di codice
// ***************************
// Scambio l'ordine dei gruppi
// ***************************
public void Vendite.Scambia()
{
// Se la categoria è il primo gruppo... diventa la seconda
if NewBook.NewReport.CategoriaGroupHeader.GroupLevel = ONE
{
NewBook.NewReport.CategoriaGroupHeader.GroupLevel := C2
}
else // Categoria diventa il primo gruppo
{
NewBook.NewReport.CategoriaGroupHeader.GroupLevel := ONE
}
//
// Aggiorno il book
this.AggiornaBook()
}
// Scambio l'ordine dei gruppi
// ***************************
public void Vendite.Scambia()
{
// Se la categoria è il primo gruppo... diventa la seconda
if NewBook.NewReport.CategoriaGroupHeader.GroupLevel = ONE
{
NewBook.NewReport.CategoriaGroupHeader.GroupLevel := C2
}
else // Categoria diventa il primo gruppo
{
NewBook.NewReport.CategoriaGroupHeader.GroupLevel := ONE
}
//
// Aggiorno il book
this.AggiornaBook()
}
Ultima modifica: 25/10/2016 / Validità: da 6.5.2680
- Normalmente questa proprietà viene utilizzata al di fuori degli eventi di formattazione della sezione per modificare dinamicamente la struttura dei gruppi del report.
- L'utilizzo della proprietà all'interno degli eventi BeforeFormatting ed AfterFormatting non ha alcun effetto.
- Dopo aver modificato il livello di raggruppamento della sezione il sistema ricalcola automaticamente i livelli di raggruppamento di tutte le altre sezioni dello stesso report.
- La modifica al livello di raggruppamento di una sezione non comporta l'aggiornamento automatico del book. Se il book è mostrato in anteprima in una videata web e si desidera aggiornare il book dopo aver cambiato il livello di raggruppamento ad una o più sezioni, occorre chiamare il metodo Refresh del book.