proprietàScopo
Indica se occorre aggiungere una scrollbar alla box qualora il testo che questa contiene superi l'altezza della box. Tale proprietà viene utilizzata unicamente se il book è mostrato in una porzione di videata.
Sintassi
boolean sb = 0 // Indica se devono apparire le scrollbar
//
sb := Box.CanScroll
//
sb := Box.CanScroll
Quando letta
Restituisce True se vengono mostrate le scrollbar nella box qualora il testo che questa contiene superi l'altezza della box, altrimenti restituisce False.
Quando impostata
Indica al sistema se occorre mostrare le scrollbar quando il testo contenuto nella box eccede l'altezza della stessa.
Esempio di codice
// ************************************
// Fired when the section is formatting
// ************************************
event Impiegati1.ImpiegatiBook.ReportImpiegati.Detail.BeforeFormatting()
{
// Indico che se il testo supera l'altezza della box, devono apparire le
// scrollbar
ImpiegatiBook.ReportImpiegati.Note.CanScroll := True
}
// Fired when the section is formatting
// ************************************
event Impiegati1.ImpiegatiBook.ReportImpiegati.Detail.BeforeFormatting()
{
// Indico che se il testo supera l'altezza della box, devono apparire le
// scrollbar
ImpiegatiBook.ReportImpiegati.Note.CanScroll := True
}
- Normalmente la proprietà CanScroll viene utilizzata nell'evento di formattazione dell'oggetto che contiene la box per indicare se è necessario far apparire delle scrollbar sulla box per leggere il testo in essa contenuto qualora questo superi l'altezza della box.
- Se il valore della proprietà VerticalResizeMode della box è impostato a Stretch (tale proprietà è visibile nella videata delle proprietà della box ed è configurabile unicamente a design-time) il sistema non farà mai apparire le scrollbar in quanto l'altezza della box verrà calcolata in automatico per accogliere interamente il testo degli span in essa contenuti.
- Attenzione: Se la proprietà CanScroll 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à CanScroll 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à CanScroll valorizzata allo stesso modo. In quest'ultimo caso è come se alla proprietà CanScroll fosse stato fornito tale valore a design-time.
- Se viene modificata la proprietà CanScroll 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 potrebbe essere necessario ristampare il book utilizzando la procedura Refresh dello stesso.
- Nel caso questa proprietà venisse usata nella Box Mastro di un Book Mobile in anteprima le box contenute nel report non risulteranno cliccabili.
Ultima modifica: 02/11/2022 / Validità: da 6.5.2680