PDFium Delphi Component Docs

AsyncRendering Egenskap

Component: TPdfView  ·  Unit: PDFium
Opt-in-flagga som talar om för vyn att rita ett litet "Loading..."-överlägg under långa renderingar så att applikationer som använder egen worker för rendering utanför huvudtråden får en konsekvent visuell signal

Syntax

property AsyncRendering: Boolean;

Description

AsyncRendering är den visuella halvan av mönstret för asynkron rendering: den uppmanar ritvägen för enskilda sidor att rita en liten inläsningsindikator (konfigurerad via LoadingText och LoadingColor) över det renderade sidområdet medan en av anroparen ägd arbetare renderar den aktuella sidan. Standardvärdet är False så att befintliga program uppgraderas utan synlig ändring

AsyncRendering flyttar inte själv renderingen till en arbetartråd. Sedan v1.37.0 serialiserar TPdf renderings- och sidurladdningsanrop per instans, så en arbetare kan rendera via samma komponent utan överlappande PDFium-renderingsanrop. Anroparen äger fortfarande arbetardrift, bitmapöverlämning och dokumentets livstid: mutera eller urladda inte dokumentet medan en rendering pågår. Använd TPdfFuture<T> från FPdfAsync för att driva arbetaren och låt AsyncRendering / LoadingText / LoadingColor sköta den visuella signalen under den pågående renderingen

Inläsningsöverlägget är en liten rektangel som ritas i mitten av sidområdet, storleksanpassad efter LoadingText-etiketten. Applikationer som behöver en annan placering, animering eller förloppsprocent bör hålla AsyncRendering avslagen och hantera överlägget direkt via 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