PDFium Component Docs

AsyncRendering Właściwość

Component: TPdfView  ·  Unit: PDFium
Flaga włączana jawnie, która każe widokowi rysować małą nakładkę "Loading..." podczas długich renderów, aby aplikacje korzystające z własnego workera do renderowania w tle miały spójny element wizualny

Syntax

property AsyncRendering: Boolean;

Description

AsyncRendering to wizualna połowa wzorca renderowania asynchronicznego: nakazuje jednustronicowej ścieżce rysowania wyświetlić mały wskaźnik ładowania (konfigurowany przez LoadingText i LoadingColor) nad renderowanym obszarem strony, podczas gdy należący do wywołującego worker renderuje bieżącą stronę. Wartość domyślna to False, więc istniejące aplikacje aktualizują się bez zmian wizualnych

AsyncRendering samo z siebie nie przenosi renderowania na wątek roboczy. Od v1.37.0 TPdf serializuje wywołania renderowania i zwalniania stron per instancja, więc worker może renderować przez ten sam komponent bez nakładania się wywołań renderowania PDFium. Wywołujący nadal jest właścicielem dyspozycji workera, przekazania bitmapy i czasu życia dokumentu: nie modyfikuj ani nie zwalniaj dokumentu, gdy renderowanie jest w toku. Użyj TPdfFuture<T> z FPdfAsync do sterowania workerem, a pozwól AsyncRendering / LoadingText / LoadingColor obsłużyć warstwę wizualną podczas renderowania w toku

Nakładka ładowania to mały prostokąt rysowany na środku obszaru strony, wymiarowany do napisu LoadingText. Aplikacje, którym potrzeba innego położenia, animacji lub procentu postępu, powinny wyłączyć AsyncRendering i obsłużyć nakładkę bezpośrednio przez OnPaint

Remarks

Example

PdfView1.AsyncRendering := True;
PdfView1.LoadingText := 'Rendering...';
PdfView1.LoadingColor := clGray;

// Kick off the actual off-thread render with TPdfFuture (FPdfAsync).
// The worker owns its own TPdf — DO NOT share PdfView1.Pdf.

See Also

LoadingText, LoadingColor, RenderPage