AsyncRendering Eigenschaft

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.

Opt-in-Flag, das die Ansicht anweist, bei langen Rendern eine kleine "Loading..."-Einblendung zu zeichnen, damit Anwendungen mit eigenem Worker für Off-Thread-Rendering dieselbe visuelle Rückmeldung erhalten

AsyncRendering ist der visuelle Teil des Async-Render-Musters: Es weist den Einzelseiten-Zeichenpfad an, während ein vom Aufrufer eigener Worker die aktuelle Seite rendert, einen kleinen Ladeindikator zu zeichnen, der über LoadingText und LoadingColor konfiguriert wird. Der Standardwert ist False, damit bestehende Anwendungen ohne sichtbare Änderung aktualisiert werden

AsyncRendering verschiebt das Rendering nicht selbst auf einen Worker-Thread. Seit v1.37.0 serialisiert TPdf Render- und Page-Unload-Aufrufe pro Instanz, sodass ein Worker über dieselbe Komponente rendern kann, ohne sich überschneidende PDFium-Renderaufrufe. Der Aufrufer behält weiterhin die Verantwortung für Worker-Dispatch, Bitmap-Übergabe und Dokumentlebensdauer: Ändern oder entladen Sie das Dokument nicht, während ein Rendering läuft. Verwenden Sie TPdfFuture<T> aus FPdfAsync, um den Worker zu steuern, und lassen Sie AsyncRendering / LoadingText / LoadingColor die visuelle Rückmeldung während des laufenden Renderings übernehmen

Die Ladeeinblendung ist ein kleines Rechteck in der Mitte des Seitenbereichs, dessen Größe sich nach der Beschriftung von LoadingText richtet. Anwendungen, die eine andere Position, Animation oder Fortschrittsanzeige benötigen, sollten AsyncRendering deaktiviert lassen und die Einblendung direkt über OnPaint behandeln

• Die Einblendung erscheint nur im Einzelseiten-Zeichenpfad; Zwei-Seiten-Spread-Modi (dmTwoPageContinuous, dmTwoPageContinuousWithCover) zeigen den Indikator derzeit nicht an. Verwenden Sie bei Bedarf ein eigenes OnPaint
• Ohne einen Worker, der tatsächlich Off-Thread arbeitet, zeichnet AsyncRendering die Einblendung auch bei einem synchronen Rendering — nützlich für sehr hochauflösende Exporte auf einer langsamen Maschine, die meisten Aufrufer kombinieren es jedoch mit TPdfFuture
• Der Renderpfad hinter RenderPage / RenderTile arbeitet ohne Kopie, wenn das Ziel-DIB sicher umschlossen werden kann, und fällt bei Bottom-up-DIB-Layouts auf einen kopierten Puffer zurück

LoadingText, LoadingColor, RenderPage