AsyncRendering Eigenschaft

AsyncRendering ist die visuelle Hälfte des Async-Render-Musters: Es weist den Einzelseiten-Paint-Pfad an, einen kleinen Ladeindikator (konfiguriert über LoadingText und LoadingColor) über den gerenderten Seitenbereich zu zeichnen, während ein vom Aufrufer betriebener Worker die aktuelle Seite rendert. Die Voreinstellung ist False, damit bestehende Anwendungen ohne sichtbare Änderung upgraden

AsyncRendering verlagert das Rendering nicht selbst auf einen Worker- Thread. Seit v1.37.0 serialisiert TPdf Render- und Seiten-Entlade-Aufrufe je Instanz, sodass ein Worker durch dieselbe Komponente rendern kann, ohne dass sich PDFium-Render-Aufrufe überlappen. Der Aufrufer besitzt weiterhin Worker-Dispatch, Bitmap-Übergabe und Dokumentlebensdauer: verändern oder entladen Sie das Dokument nicht, während ein Rendering unterwegs ist. Treiben Sie den Worker mit TPdfFuture<T> aus FPdfAsync an, und überlassen Sie AsyncRendering / LoadingText / LoadingColor die visuelle Rückmeldung während des laufenden Renderings

Das Lade-Overlay ist ein kleines Rechteck in der Mitte des Seitenbereichs, dimensioniert nach der LoadingText-Beschriftung. Anwendungen, die andere Platzierung, Animation oder Fortschrittsprozente brauchen, lassen AsyncRendering aus und handhaben das Overlay direkt über OnPaint

• Das Overlay feuert nur aus dem Einzelseiten-Paint-Pfad; Doppelseiten-Modi (dmTwoPageContinuous, dmTwoPageContinuousWithCover) zeigen den Indikator derzeit nicht. Wer ihn in beiden Modi braucht, verdrahtet eigenes OnPaint
• Ohne einen Worker, der real nebenläufig arbeitet, zeichnet AsyncRendering das Overlay auch während eines Sync-Renderings — nützlich für sehr hochauflösende Exporte auf langsamer Maschine, aber die meisten Aufrufer kombinieren es mit TPdfFuture
• Der Render-Pfad hinter RenderPage / RenderTile ist zero-copy, wenn die Ziel-DIB sich sicher wrappen lässt, und fällt bei Bottom-up-DIB-Layouts auf einen kopierten Puffer zurück