proceduraScopo
Aggiunge un valore alla lista valori associata allo span. Tale proprietà viene utilizzata unicamente se il book è contenuto in una porzione di videata web.
Sintassi
Book.Report.Span.SetSpanValueListItem(nome, valore, descrizione, [stile])
Argomenti
| Nome | E' una stringa che contiene il nome associato al possibile valore dello span. Il nome viene mostrato all'interno della Combo Box dei possibili valori dello stesso. Qualora lo span venga mostrato come Option Button il nome viene posizionato accanto al bottoncino di selezione del valore |
| Descrizione | E' una stringa che contiene la descrizione associata al possibile valore dello span. Qualora lo span venga mostrato come Option Button la descrizione viene mostrata come tooltip quando il mouse passa sopra il singolo valore. Se lo span non viene mostrato come Option Button tale argomento non viene utilizzato |
| Valore | E' una stringa che contiene il possibile valore dello span. Tale stringa rappresenta il valore fisico che viene assegnato allo span quando viene selezionato uno dei possibili valori dello span |
| Stile | Parametro opzionale di tipo intero che rappresenta lo stile visuale associato al valore della lista. |
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 SetSpanValueListItem 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 SetSpanValueListItem 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 conterranno il nuovo possibile valore. In quest'ultimo caso è come se, a design-time, fosse stato inserito questo possibile valore tra quelli definiti per lo span.
- Se la procedura SetSpanValueListItem 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 SetSpanValueListItem 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 SetSpanValueListItem anche nell'evento AfterFormatting della sezione che contiene lo span.
Ultima modifica: 02/11/2022 / Validità: da 6.5.2680