AsyncRendering Proprietà

AsyncRendering è la metà visiva del pattern di render asincrono: dice al percorso di paint a pagina singola di disegnare un piccolo indicatore di caricamento (configurato tramite LoadingText e LoadingColor) sull'area di pagina renderizzata mentre un worker del chiamante renderizza la pagina corrente. Il predefinito è False così le applicazioni esistenti si aggiornano senza alcun cambiamento visivo

AsyncRendering non sposta da solo il rendering su un thread worker. Dalla v1.37.0 TPdf serializza le chiamate di render e di scarico pagina per istanza, quindi un worker può renderizzare attraverso lo stesso componente senza sovrapporre chiamate di render PDFium. Il chiamante resta proprietario della dispatch del worker, del passaggio di bitmap e del ciclo di vita del documento: non mutare né scaricare il documento mentre un render è in volo. Usa TPdfFuture<T> da FPdfAsync per guidare il worker, e lascia che AsyncRendering / LoadingText / LoadingColor gestiscano l'indicatore visivo durante il render in volo

L'overlay di caricamento è un piccolo rettangolo disegnato al centro dell'area pagina, dimensionato sulla caption LoadingText. Le applicazioni che richiedono una diversa posizione, animazione o percentuale di avanzamento dovrebbero tenere AsyncRendering spento e gestire l'overlay tramite OnPaint direttamente

• L'overlay parte solo dal percorso di paint a pagina singola; le modalità a due pagine (dmTwoPageContinuous, dmTwoPageContinuousWithCover) attualmente non mostrano l'indicatore. Collega il tuo OnPaint se servono anche quelle modalità
• Senza un worker che fa lavoro davvero fuori thread, AsyncRendering disegna comunque l'overlay durante un render sincrono — utile per esportazioni a DPI molto alti su una macchina lenta, ma la maggior parte dei chiamanti lo combinerà con TPdfFuture
• Il percorso di render che sta dietro a RenderPage / RenderTile è zero-copy quando la DIB di destinazione può essere incapsulata in sicurezza, e ricade su un buffer copiato per i layout DIB bottom-up