proprietàScopo
Questa proprietà indica se la sezione è visibile o meno. Tale informazione viene utilizzata dal motore di stampa per decidere se mostrare o meno la sezione, e quindi tutto il suo contenuto, quando viene stampato il book che la contiene.
Sintassi
boolean vis = 0 // La sezione è visibile?
//
vis := Sezione.Visible
//
vis := Sezione.Visible
Quando letta
Ritorna True se la sezione è visibile, False altrimenti.
Quando impostata
Mostra o nasconde la sezione.
Esempio di codice
// ************************************
// Fired when the section is formatting
// ************************************
event CategorieBook.CategorieBook.ReportCategorie.CategorieDettagli.
BeforeFormatting()
{
// Questa sezione è un DETAIL ma contiene i dettagli della categoria.
// Io voglio stamparla solo la prima volta all'interno del gruppo delle
// categorie quindi la stampo solo se la funzione RecordNumber coincide con
// quella del GroupHeader
if CategorieBook.ReportCategorie.CategorieDettagli.RecordNumber() <>
CategorieBook.ReportCategorie.IdcategoriaGroupHeader.RecordNumber()
{
CategorieBook.ReportCategorie.CategorieDettagli.Visible := False
}
}
// Fired when the section is formatting
// ************************************
event CategorieBook.CategorieBook.ReportCategorie.CategorieDettagli.
BeforeFormatting()
{
// Questa sezione è un DETAIL ma contiene i dettagli della categoria.
// Io voglio stamparla solo la prima volta all'interno del gruppo delle
// categorie quindi la stampo solo se la funzione RecordNumber coincide con
// quella del GroupHeader
if CategorieBook.ReportCategorie.CategorieDettagli.RecordNumber() <>
CategorieBook.ReportCategorie.IdcategoriaGroupHeader.RecordNumber()
{
CategorieBook.ReportCategorie.CategorieDettagli.Visible := False
}
}
- Normalmente la proprietà Visible viene valorizzata all'interno degli eventi di formattazione della sezione per indicare se occorre stampare o meno la copia della sezione stessa.
- Se una sezione viene resa invisibile (assegnando il valore False alla proprietà Visible) le box e gli span in essa contenuti non vengono stampati.
- Attenzione: Se la proprietà Visible viene modificata all'interno dell'evento BeforeFormatting la modifica ha effetto solo sulla sezione in fase di formattazione (consulta il videocorso Mastro On Formatting). Se la proprietà Visible viene modificata al di fuori dagli eventi di formattazione della sezione, da quel momento in poi tutte le copie della sezione avranno la proprietà Visible valorizzata allo stesso modo. In quest'ultimo caso è come se alla proprietà Visible fosse stato fornito tale valore a design-time.
- Attenzione: La modifica alla proprietà Visible nell'evento AfterFormatting non ha alcun effetto poiché la sezione è già stata posizionata sulla pagina in fase di formattazione.
- Attenzione: Se la sezione viene resa invisibile fuori dagli eventi di formattazione non verrà creata la copia prima della formattazione. Questo vuol dire che non sarà possibile renderla visibile durante gli stessi eventi di formattazione che non vengono, infatti, notificati.
- Se la proprietà Visible viene modificata all'interno di una procedura legata ad una box attiva contenuta nella sezione tale modifica ha effetto solo sulla singola copia della sezione. Tale modifica equivale ad una modifica alla proprietà fatta all'interno degli eventi di formattazione della sezione che contiene la box.
- Se una sezione viene nascosta nell'evento di BeforeFormatting non verrà notificato l'evento di AfterFormatting poiché l'operazione di formattazione viene interrotta dopo la notifica dell'evento di BeforeFormatting.
- Se viene modificata la proprietà Visible durante gli eventi di formattazione della sezione o durante la procedura collegata ad una box attiva contenuta nella sezione non è necessario ristampare il book. Tale modifica avrà effetto immediato. Qualora, invece, la modifica sia fatta fuori dagli eventi di validazione e non all'interno della procedura collegata alla box attiva potrebbe essere necessario ristampare il book utilizzando la procedura Refresh dello stesso.
- A partire dalla versione 13.0.5600 è possibile modificare il valore della proprietà Visible anche nell'evento AfterFormatting anche se, in questo caso, non sarà possibile recuperare lo spazio che sarebbe stato occupato dalla sezione sulla pagina.
Ultima modifica: 02/11/2022 / Validità: da 6.5.2680