proprietàScopo
La proprietà Text contiene il testo che viene utilizzato dal motore di stampa per mostrare lo span. Tale proprietà viene calcolata durante la formattazione del book a partire dal valore della proprietà Value. Se lo span è di tipo Label il valore viene inizializzato a ciò che è stato definito a design-time nel campo Descrizione. Se lo span non è di tipo Label il valore corrisponde al risultato dell'espressione contenuta nello span calcolato a run-time.
Sintassi
string v = "" // Testo dello span
//
v := Span.Text
//
v := Span.Text
Quando letta
Restituisce il testo che verrà utilizzato dal sistema per mostrare lo span.
Quando impostata
Indica al sistema quale testo occorre mostrare quando un book contenente lo span viene stampato.
Esempio di codice
// ************************************
// Fired when the section is formatting
// ************************************
event OrdiniBook.BookOrdini.Ordini.AnnoOrdineGroupHeader.BeforeFormatting()
{
// Se ho poca statistica, lo segnalo
if ToInteger(BookOrdini.Ordini.CountQtà.Value) < C5
{
BookOrdini.Ordini.MediaQtà.Text := N.D.
BookOrdini.Ordini.VarianzaQtà.Text := N.D.
BookOrdini.Ordini.SigmaQtà.Text := N.D.
}
}
// Fired when the section is formatting
// ************************************
event OrdiniBook.BookOrdini.Ordini.AnnoOrdineGroupHeader.BeforeFormatting()
{
// Se ho poca statistica, lo segnalo
if ToInteger(BookOrdini.Ordini.CountQtà.Value) < C5
{
BookOrdini.Ordini.MediaQtà.Text := N.D.
BookOrdini.Ordini.VarianzaQtà.Text := N.D.
BookOrdini.Ordini.SigmaQtà.Text := N.D.
}
}
-
Quando viene modificata la proprietà Value il sistema ricalcola il valore della proprietà Text nel modo seguente:
- Viene convertito il nuovo valore nel tipo di dato dello span.
- Se lo span ha un visual style e questo possiede una maschera di formattazione il sistema la utilizza per convertire il valore in una stringa; se lo span non ha un proprio visual style o non possiede una maschera di formattazione, il sistema utilizza il valore delle costanti di compilazione _ICD_DefaultCurrencyMask, _ICD_DefaultFloatMask, _ICD_DefaultDateMask, _ICD_DefaultTimeMask a seconda del tipo di dato dello span.
- Infine, se lo span possiede una lista valori il sistema ne analizza le costanti alla ricerca di quella il cui valore coincide con il valore della proprietà Value dello span. Se viene trovata tale costante il sistema assegna alla proprietà Text il nome della costante e, se il flag ShowValue del visual style utilizzato dallo span è attivato, vi concatena la descrizione.
- Attenzione: Se la proprietà Text 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 è contenuto 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à Text 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à Text valorizzata allo stesso modo. In quest'ultimo caso è come se alla proprietà Text fosse stato fornito tale valore a design-time. Se poi la proprietà Value viene modificata durante gli eventi di formattazione, la proprietà Text dello span in fase di formattazione verrà ricalcolata di conseguenza.
- Se la proprietà Text 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à Text 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à Text anche nell'evento AfterFormatting della sezione che contiene lo span.
Ultima modifica: 02/11/2022 / Validità: da 6.5.2680