Scopo
Cancella la lista valori associata allo span, preparandola al successivo riempimento. Tale proprietà viene utilizzata unicamente se il book è contenuto in una porzione di videata web.
Sintassi
Book.Report.Span.EmptyValueList()
Argomenti
Questa procedura non ha argomenti.Esempio di codice
// *******************************************
// Sblocca il book per permettere le modifiche
// *******************************************
public void ImpiegatiBookMod.UnlockBook()
{
// Il book è sbloccato
Parametri.BookBloccato := False
//
// Abilito in scrittura gli span
ImpiegatiBook.ReportImp.TitoloImpiegati.Enabled := True
ImpiegatiBook.ReportImp.CognomeImpiegati.Enabled := True
ImpiegatiBook.ReportImp.NomeImpiegati.Enabled := True
//
// Mostro il riguadro attorno alle box modificabili... così si vedono
ImpiegatiBook.ReportImp.Cognome.VisualStyle := RiquadroBianco
ImpiegatiBook.ReportImp.Nome.VisualStyle := RiquadroBianco
//
// Definisco i possibili valori del campo TITOLO
ImpiegatiBook.ReportImp.TitoloImpiegati.EmptyValueList()
ImpiegatiBook.ReportImp.TitoloImpiegati.SetSpanValueListItem(Dott.,
Dott., Dott.)
ImpiegatiBook.ReportImp.TitoloImpiegati.SetSpanValueListItem(Dott.ssa,
Dott.ssa, Dott.ssa)
ImpiegatiBook.ReportImp.TitoloImpiegati.SetSpanValueListItem(Ing., Ing.
, Ing.)
//
// Aggiorno tutto il book
ImpiegatiBook.Refresh(ONE, C-1)
}
// Sblocca il book per permettere le modifiche
// *******************************************
public void ImpiegatiBookMod.UnlockBook()
{
// Il book è sbloccato
Parametri.BookBloccato := False
//
// Abilito in scrittura gli span
ImpiegatiBook.ReportImp.TitoloImpiegati.Enabled := True
ImpiegatiBook.ReportImp.CognomeImpiegati.Enabled := True
ImpiegatiBook.ReportImp.NomeImpiegati.Enabled := True
//
// Mostro il riguadro attorno alle box modificabili... così si vedono
ImpiegatiBook.ReportImp.Cognome.VisualStyle := RiquadroBianco
ImpiegatiBook.ReportImp.Nome.VisualStyle := RiquadroBianco
//
// Definisco i possibili valori del campo TITOLO
ImpiegatiBook.ReportImp.TitoloImpiegati.EmptyValueList()
ImpiegatiBook.ReportImp.TitoloImpiegati.SetSpanValueListItem(Dott.,
Dott., Dott.)
ImpiegatiBook.ReportImp.TitoloImpiegati.SetSpanValueListItem(Dott.ssa,
Dott.ssa, Dott.ssa)
ImpiegatiBook.ReportImp.TitoloImpiegati.SetSpanValueListItem(Ing., Ing.
, Ing.)
//
// Aggiorno tutto il book
ImpiegatiBook.Refresh(ONE, C-1)
}
- Attenzione: Se la procedura EmptyValueList viene chiamata all'interno degli eventi di formattazione dell'oggetto che contiene lo span (evento OnFormatting della pagina se lo span è contenuto in una box di pagina o evento di BeforeFormatting della sezione se lo span è contenuto in una box di sezione) la modifica della lista valori ha effetto solo sullo span in fase di formattazione (consulta il videocorso Mastro On Formatting). Se la procedura EmptyValueList viene chiamata al di fuori dagli eventi di formattazione dell'oggetto che contiene lo span, da quel momento in poi tutte le copie dello span non avranno una propria lista dei possibili valori. In quest'ultimo caso è come se, a design-time, fosse stato indicato che lo span non possiede liste valori.
- Se la procedura EmptyValueList viene chiamata all'interno di una procedura legata alla box che contiene lo span la modifica della lista valori ha effetto solo sulla singola copia dello span. Tale modifica equivale ad una modifica della lista valori fatta all'interno degli eventi di formattazione dell'oggetto che contiene lo span.
- Se viene chiamata la procedura EmptyValueList durante gli eventi di formattazione dell'oggetto che contiene lo span o durante la procedura collegata alla box che contiene lo span non è necessario ristampare il book. Tale modifica avrà effetto immediato. Qualora, invece, la chiamata sia fatta fuori dagli eventi di validazione e non all'interno della procedura collegata alla box che contiene lo span potrebbe essere necessario ristampare il book utilizzando la procedura Refresh dello stesso.
- A partire dalla versione 13.0.5600 è possibile utilizzare il metodo EmptyValueList anche nell'evento AfterFormatting della sezione che contiene lo span.
Ultima modifica: 02/11/2022 / Validità: da 6.5.2680