proprietàScopo
Questa proprietà rappresenta l'altezza della sezione.
Sintassi
int dy = 0 // Altezza della sezione
//
dy := Sezione.Height
//
dy := Sezione.Height
Quando letta
Ritorna l'altezza della sezione ed è misurata in millimetri.
Quando impostata
Imposta l'altezza della sezione in millimetri.
Esempio di codice
// ******************************************
// Fired after the section has been formatted
// ******************************************
event CategorieBook.CategorieBook.ReportCategorie.CategorieDettagli.
AfterFormatting()
{
// Ricalcolo l'altezza dell'immagine... in funzione dell'altezza della
// sezione... solo ora, infatti, so quanto è cresciuta la sezione a causa
// della box Descrizione che ha il VerticalResizeMode impostato a Stretch
CategorieBook.ReportCategorie.Immagine.Height := CategorieBook.
ReportCategorie.CategorieDettagli.Height - CategorieBook.ReportCategorie.
Immagine.Top - ONE
}
// Fired after the section has been formatted
// ******************************************
event CategorieBook.CategorieBook.ReportCategorie.CategorieDettagli.
AfterFormatting()
{
// Ricalcolo l'altezza dell'immagine... in funzione dell'altezza della
// sezione... solo ora, infatti, so quanto è cresciuta la sezione a causa
// della box Descrizione che ha il VerticalResizeMode impostato a Stretch
CategorieBook.ReportCategorie.Immagine.Height := CategorieBook.
ReportCategorie.CategorieDettagli.Height - CategorieBook.ReportCategorie.
Immagine.Top - ONE
}
- Normalmente la proprietà Height viene valorizzata all'interno degli eventi di formattazione della sezione per impostare l'altezza della singola copia della sezione.
-
Se la sezione contiene una o più box aventi la proprietà VerticalResizeMode impostata a Stretch il sistema, dopo aver formattato le box e quindi averne calcolato l'altezza in funzione della lunghezza del testo in esse contenuto, ricalcola automaticamente l'altezza della sezione cercando di conservare lo spazio tra la box più in basso e il bordo inferiore della sezione definito a design time, come mostrato nell'immagine seguente:
La dimensione del bordo mostrata in figura viene calcolata dal sistema dopo aver notificato l'evento di BeforeFormatting. Quindi se l'altezza della sezione viene modificata nell'evento BeforeFormatting il bordo sarà calcolato utilizzando tale altezza e non quella definita a design-time.
Durante la formattazione della sezione il sistema cerca di conservare lo spazio tra la box più in basso e l'altezza della sezione come definita a design-time. - Se la sezione contiene una o più box aventi la proprietà VerticalResizeMode impostata a Stretch è possibile leggere il valore della proprietà Height nell'evento AfterFormatting. In tale evento, infatti, l'altezza della sezione è quella calcolata dal sistema dopo l'allungamento delle box con altezza dinamica.
- Attenzione: Se la proprietà Height viene modificata all'interno dell'evento BeforeFormatting la modifica ha effetto solo sulla sezione in fase di formattazione (consulta il videocorso Mastro On Formatting). Se la proprietà Height viene modificata al di fuori dagli eventi di formattazione della sezione, da quel momento in poi tutte le copie della sezione avranno la proprietà Height valorizzata allo stesso modo. In quest'ultimo caso è come se alla proprietà Height fosse stato fornito tale valore a design-time.
- Attenzione: La modifica alla proprietà Height nell'evento AfterFormatting o in una procedura legata ad una box cliccabile contenuta nella sezione non ha alcun effetto poiché la sezione è già stata posizionata sulla pagina in fase di formattazione.
- A partire dalla versione 13.0.5600 è possibile modificare il valore della proprietà Height anche nell'evento AfterFormatting anche se le sezioni che seguono quella in fase di formattazione non verranno spostate.
Ultima modifica: 02/11/2022 / Validità: da 6.5.2680