funzioneScopo
Questa funzione restituisce il numero totale delle pagine del book. Normalmente viene utilizzata come espressione in uno span della pagina Mastro per mostrare il numero totale di pagine.
Sintassi
int NumeroTotalePagine = 0 // Numero di pagine del book
//
NumeroTotalePagine := Book.NumberofPages()
//
NumeroTotalePagine := Book.NumberofPages()
Argomenti
Questa funzione non ha argomenti.Valore di ritorno
Viene restituito il numero totale di pagine presenti nel book, conosciuto al momento della chiamata alla funzione. Se il valore della funzione NumberofPagesConfirmed è True, il valore restituito dalla NumberOfPages è quello corretto. Se, invece, il valore della funzione NumberofPagesConfirmed è False la funzione restituisce il valore conosciuto dal sistema al momento della chiamata alla funzione.
Esempio di codice
// *********************
// Stampa il book su PDF
// *********************
public void Prodotti.StampaSuPDF()
{
int NumeroPagine = 0 //
//
ProdottiBook.PrintDestination := PDF
ProdottiBook.Print(ONE, C-1)
//
// Recupero il numero di pagine prodotte
NumeroPagine := ProdottiBook.NumberofPages()
//
// Apro il PDF in un nuovo browser
EsempiLB.OpenDocument(ProdottiBook.WebFileName(), ??, ??)
}
// Stampa il book su PDF
// *********************
public void Prodotti.StampaSuPDF()
{
int NumeroPagine = 0 //
//
ProdottiBook.PrintDestination := PDF
ProdottiBook.Print(ONE, C-1)
//
// Recupero il numero di pagine prodotte
NumeroPagine := ProdottiBook.NumberofPages()
//
// Apro il PDF in un nuovo browser
EsempiLB.OpenDocument(ProdottiBook.WebFileName(), ??, ??)
}
- Se si utilizza la funzione NumberofPages nell'espressione di uno span per indicare, per esempio, il numero totale di pagine del book occorre selezionare il flag PrecountPages visibile nella videata delle proprietà del book. Questo è necessario perché la funzione restituisce il numero di pagine conosciuto al momento della chiamata e quando il sistema prepara la stampa della pagina 1 la chiamata alla funzione restituisce 0 in quanto il sistema non ha ancora terminato di processare né la pagina corrente né le pagine successive. Con il flag PrecountPages impostato, il sistema stampa il book due volte: la seconda volta (quella definitiva) il numero totale di pagine è noto e le chiamate alla funzione NumberofPages restituiscono il valore corretto dato che il sistema memorizza il numero totale delle pagine dopo il primo giro.
- Se il flag PrecountPages è attivato e si stampa il book la funzione NumberofPagesConfirmed restituisce il valore False durante il primo giro di stampa ed il valore False durante il secondo giro di stampa.
- Non è necessario impostare il flag PrecountPages, visibile nella videata delle proprietà del book, se si ha solo necessità di conoscere il numero di pagine stampate dopo aver stampato il book e quindi se si chiama la funzione dopo la procedura Print. Al termine della stampa, infatti, il sistema conosce il numero totale di pagine ed il numero restituito dalla funzione è comunque quello corretto.
Ultima modifica: 06/10/2021 / Validità: da 6.5.2680