proprietàScopo
La proprietà Enabled indica se lo span è modificabile dall'utente o meno. Tale proprietà ha effetto solo se il book è contenuto in una porzione di videata web.
Normalmente questa proprietà viene utilizzata negli eventi di formattazione degli oggetti che contengono gli span per indicare se sono scrivibili o meno.
Sintassi
boolean ena = False // Lo span è scrivibile?
//
ena := Span.Enabled
//
ena := Span.Enabled
Quando letta
Restituisce True se lo span è scrivibile, False altrimenti.
Quando impostata
Indica al sistema se lo span è scrivibile.
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 proprietà Enabled viene modificata 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 è contenuta in una box di sezione) la modifica ha effetto solo sullo span in fase di formattazione (consulta il videocorso Mastro On Formatting). Se la proprietà Enabled viene modificata al di fuori dagli eventi di formattazione dell'oggetto che contiene lo span, da quel momento in poi tutte le copie dello span avranno la proprietà Enabled valorizzata allo stesso modo. In quest'ultimo caso è come se alla proprietà Enabled fosse stato fornito tale valore a design-time.
- Se la proprietà Enabled viene modificata all'interno di una procedura legata alla box che contiene lo span tale modifica ha effetto solo sulla singola copia dello span. Tale modifica equivale ad una modifica alla proprietà fatta all'interno degli eventi di formattazione dell'oggetto che contiene lo span.
- Se viene modificata la proprietà Enabled 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 modifica 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 modificare il valore della proprietà Enabled anche nell'evento AfterFormatting della sezione che contiene lo span.
Ultima modifica: 02/11/2022 / Validità: da 6.5.2680