AsyncRendering Propiedad

AsyncRendering es la mitad visual del patrón de renderizado asíncrono: le indica a la ruta de pintado de una sola página que dibuje un pequeño indicador de carga (configurado mediante LoadingText y LoadingColor) sobre el área de página renderizada mientras un trabajador propiedad del llamador renderiza la página actual. El valor predeterminado es False para que las aplicaciones existentes se actualicen sin cambio visual.

AsyncRendering no empuja por sí mismo el renderizado a un hilo trabajador. Desde v1.37.0, TPdf serializa las llamadas de renderizado y de descarga de página por instancia, de modo que un trabajador puede renderizar a través del mismo componente sin solapar llamadas de renderizado de PDFium. El llamador sigue siendo propietario del despacho del trabajador, la entrega del bitmap y la vida útil del documento: no mute ni descargue el documento mientras un renderizado está en curso. Use TPdfFuture<T> de FPdfAsync para impulsar el trabajador y deje que AsyncRendering / LoadingText / LoadingColor manejen la affordance visual durante el renderizado en curso.

La superposición de carga es un pequeño rectángulo dibujado en el centro del área de página, dimensionado según el título LoadingText. Las aplicaciones que necesiten una ubicación, animación o porcentaje de progreso distintos deberían mantener AsyncRendering desactivado y manejar la superposición a través de OnPaint directamente.

• La superposición solo se dispara desde la ruta de pintado de una sola página; los modos extendidos de dos páginas (dmTwoPageContinuous, dmTwoPageContinuousWithCover) actualmente no muestran el indicador. Cablee su propio OnPaint si ambos modos lo necesitan.
• Sin un trabajador realizando trabajo real fuera del hilo, AsyncRendering sigue dibujando la superposición durante un renderizado síncrono — útil para exportaciones a DPI muy alto en una máquina lenta, pero la mayoría de los llamadores lo combinarán con TPdfFuture.
• La ruta de renderizado que respalda RenderPage / RenderTile es de copia cero cuando el DIB de destino puede envolverse de forma segura y recurre a un búfer copiado para disposiciones DIB de abajo a arriba.