proceduraScopo
Se uno dei report che compongono il book contiene delle query parametriche, cioè che dipendono da parametri IMDB, solitamente il book si aggiorna automaticamente quando questi parametri variano. Questo, tuttavia, avviene in alcuni momenti specifici, quindi, se si vuole che il book si aggiorni in un punto del codice a piacere deve essere chiamata la procedura UpdateBook.
Al momento della chiamata a questa procedura il book valuta se i valori dei parametri delle proprie query sono cambiati ed, in questo caso, elimina le eventuali copie delle pagine già stampate e ri-stampa tutto il book fino a tornare alla pagina attualmente mostrata all'utente.
Tale procedura è da utilizzare solo se il book è contenuto in una porzione di videata.
Sintassi
Book.UpdateBook()
Argomenti
Questa procedura non ha argomenti.Esempio di codice
// Fired after changes in panel are saved to database
// **************************************************
event FornitoriBook.Filtro.AfterCommit(
int RowsUpdated // Number of rows inserted or updated
int RowsInErrors // Number of rows that cannot be updated due to databas...
)
{
// Chiedo al book di aggiornarsi dato che è cambiato il valore del parametro
// della query. Dopo questa riga di codice il book è già stato aggiornato e
// posso quindi chiedere al report quante righe sono state trovate nella query
BookFornitori.UpdateBook()
//
// Se il report non ha dati, allora segnalo l'errore
if BookFornitori.ReportFornitori.RecordsCount() = ZERO
{
EsempiLB.MessageBox(MSG Report Vuoto)
//
// Porto lì il cursore
Filtro.Paese.SetFocus()
}
}
- Normalmente non è necessario chiamare questa procedura. Essa viene già eseguita dal sistema durante la fase di UpdateControls della videata.
- Può essere necessario chiamare la procedura UpdateBook se si desidera che il book venga aggiornato prima della fase di UpdateControls della videata per conoscere in anticipo informazioni quali il numero di pagine, il numero di records restituite dalle query del reports, etc.
- Questa procedura è diversa dalla procedura Refresh in quanto quest'ultima aggiorna comunque il book anche se il valore dei parametri non è cambiato, inoltre la Refresh non riesegue le query su cui il report è basato.
Ultima modifica: 23/03/2021 / Validità: da 6.5.2680