proprietàScopo
La proprietà VisualStyle è un numero intero che rappresenta lo stile visuale utilizzato dalla box.
Sintassi
int vis = 0 // Stile visuale della box
//
vis := Box.VisualStyle
//
vis := Box.VisualStyle
Quando letta
Restituisce un numero intero che indica quale stile visuale è utilizzato dalla box. Il valore restituito corrisponde ad uno degli stili visuali presenti nel progetto.
Quando impostata
Indica quale stile visuale deve essere utilizzato per mostrare la box.
Esempio di codice
// ************************************
// Fired when the section is formatting
// ************************************
event BookDD.BookDD.ReportDD.Detail.BeforeFormatting()
{
// Posiziono la box
BookDD.ReportDD.Pezzo.Left := BookDD.LeftPezzo
BookDD.ReportDD.Pezzo.Top := BookDD.TopPezzo
BookDD.ReportDD.Pezzo.Width := BookDD.WidthPezzo
BookDD.ReportDD.Pezzo.Height := BookDD.HeightPezzo
//
// Preparo i vari flags che indicano cosa può fare la box
if BookDD.TrasformabilePezzo = True
{
BookDD.ReportDD.Pezzo.CanTransform := True
}
if BookDD.DraggabilePezzo = True
{
BookDD.ReportDD.Pezzo.CanDrag := True
}
if BookDD.DroppabilePezzo = True
{
BookDD.ReportDD.Pezzo.CanDrop := True
}
//
// Coloro la box
if BookDD.ReportDD.Pezzo.CanTransform
{
BookDD.ReportDD.Pezzo.VisualStyle := SfondoVerde
}
if BookDD.ReportDD.Pezzo.CanDrag
{
BookDD.ReportDD.Pezzo.VisualStyle := SfondoGiallo
}
if BookDD.ReportDD.Pezzo.CanDrop
{
BookDD.ReportDD.Pezzo.VisualStyle := SfondoRosso
}
}
// Fired when the section is formatting
// ************************************
event BookDD.BookDD.ReportDD.Detail.BeforeFormatting()
{
// Posiziono la box
BookDD.ReportDD.Pezzo.Left := BookDD.LeftPezzo
BookDD.ReportDD.Pezzo.Top := BookDD.TopPezzo
BookDD.ReportDD.Pezzo.Width := BookDD.WidthPezzo
BookDD.ReportDD.Pezzo.Height := BookDD.HeightPezzo
//
// Preparo i vari flags che indicano cosa può fare la box
if BookDD.TrasformabilePezzo = True
{
BookDD.ReportDD.Pezzo.CanTransform := True
}
if BookDD.DraggabilePezzo = True
{
BookDD.ReportDD.Pezzo.CanDrag := True
}
if BookDD.DroppabilePezzo = True
{
BookDD.ReportDD.Pezzo.CanDrop := True
}
//
// Coloro la box
if BookDD.ReportDD.Pezzo.CanTransform
{
BookDD.ReportDD.Pezzo.VisualStyle := SfondoVerde
}
if BookDD.ReportDD.Pezzo.CanDrag
{
BookDD.ReportDD.Pezzo.VisualStyle := SfondoGiallo
}
if BookDD.ReportDD.Pezzo.CanDrop
{
BookDD.ReportDD.Pezzo.VisualStyle := SfondoRosso
}
}
- Attenzione: Se la proprietà VisualStyle viene modificata all'interno degli eventi di formattazione dell'oggetto che contiene la box (evento OnFormatting della pagina se la box è contenuta nella pagina o evento di BeforeFormatting della sezione se la box è contenuta in una sezione) la modifica ha effetto solo sulla box 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 la box, da quel momento in poi tutte le copie della box 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 tale modifica ha effetto solo sulla singola copia della box. 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 la box o durante la procedura collegata alla box 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 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. - A partire dalla versione 13.0.5600 è possibile modificare il valore della proprietà VisualStyle anche nell'evento AfterFormatting della sezione che contiene la box.
Ultima modifica: 02/11/2022 / Validità: da 6.5.2680