proprietàScopo
La proprietà VisualStyle è un numero intero che rappresenta lo stile visuale utilizzato dallo span.
Sintassi
int vis = 0 // Stile visuale dello span
//
vis := Span.VisualStyle
//
vis := Span.VisualStyle
Quando letta
Restituisce un numero intero che indica quale stile visuale è utilizzato dallo span. Il valore restituito corrisponde ad uno degli stili visuali presenti nel progetto.
Quando impostata
Indica quale stile visuale deve essere utilizzato per mostrare lo span.
Esempio di codice
// ************************************
// Fired when the section is formatting
// ************************************
event ImpiegatiBook.ImpiegatiBook.NewReport.Detail.BeforeFormatting()
{
// Se non c'è un superiore, nascondo gli span
if IsNull(ImpiegatiBook.SuperioreImpiegati) OR ImpiegatiBook.
SuperioreImpiegati = ImpiegatiBook.IdimpiegatoImpiegati
{
ImpiegatiBook.NewReport.CognomeImpiegati2Categorie.Visible := False
ImpiegatiBook.NewReport.Space.Visible := False
ImpiegatiBook.NewReport.NomeImpiegati2Categorie.Visible := False
}
//
// Se sono sul superiore, coloro di rosso il nome
if ImpiegatiBook.SuperioreImpiegati = ImpiegatiBook.
IdimpiegatoImpiegati
{
ImpiegatiBook.NewReport.CognomeImpiegatiCategorie.VisualStyle :=
AlternatoRossoBold
ImpiegatiBook.NewReport.NomeImpiegatiCategorie.VisualStyle :=
AlternatoRossoBold
ImpiegatiBook.NewReport.IdimpiegatoImpiegatiCategorie.VisualStyle :=
AlternatoRossoBold
}
}
// Fired when the section is formatting
// ************************************
event ImpiegatiBook.ImpiegatiBook.NewReport.Detail.BeforeFormatting()
{
// Se non c'è un superiore, nascondo gli span
if IsNull(ImpiegatiBook.SuperioreImpiegati) OR ImpiegatiBook.
SuperioreImpiegati = ImpiegatiBook.IdimpiegatoImpiegati
{
ImpiegatiBook.NewReport.CognomeImpiegati2Categorie.Visible := False
ImpiegatiBook.NewReport.Space.Visible := False
ImpiegatiBook.NewReport.NomeImpiegati2Categorie.Visible := False
}
//
// Se sono sul superiore, coloro di rosso il nome
if ImpiegatiBook.SuperioreImpiegati = ImpiegatiBook.
IdimpiegatoImpiegati
{
ImpiegatiBook.NewReport.CognomeImpiegatiCategorie.VisualStyle :=
AlternatoRossoBold
ImpiegatiBook.NewReport.NomeImpiegatiCategorie.VisualStyle :=
AlternatoRossoBold
ImpiegatiBook.NewReport.IdimpiegatoImpiegatiCategorie.VisualStyle :=
AlternatoRossoBold
}
}
- Attenzione: Se la proprietà VisualStyle 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à VisualStyle 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à VisualStyle valorizzata allo stesso modo. In quest'ultimo caso è come se alla proprietà VisualStyle fosse stato fornito tale valore a design-time.
- Se la proprietà VisualStyle 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 la box.
- Se viene modificata la proprietà VisualStyle 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.
-
Attenzione: Quando Instant Developer compila l'applicazione assegna a tutti gli span che non hanno un proprio stile visuale (e che quindi hanno la proprietà Visual Style non valorizzata) lo stile visuale della box che li contiene, qualora quest'ultima abbia un proprio stile visuale.
La modifica della proprietà VisualStyle della box a run-time NON viene automaticamente applicata anche agli span contenuti nella box anche se questi non hanno un proprio stile visuale. -
Se lo span si riferisce ad una colonna di tipo BLOB esso viene mostrato all'interno della box che contiene lo span se il BLOB contiene un'immagine o un testo e lo stile visuale associato allo span non ha il flag Hyperlink attivato. Negli altri casi all'interno dello span viene inserito un hyperlink il cui testo viene preso dalla proprietà ToolTip. Cliccando sul link viene aperto il BLOB in una nuova finestra.
Se il book viene stampato su PDF il contenuto del BLOB, qualora contenga un'immagine o un testo, viene direttamente inserito all'interno dello span indipendentemente dallo stato del flag Hyperlink dello stile visuale utilizzato dallo span. - A partire dalla versione 13.0.5600 è possibile modificare il valore della proprietà VisualStyle anche nell'evento AfterFormatting della sezione che contiene lo span.
Ultima modifica: 02/11/2022 / Validità: da 6.5.2680