Esta entrada API conserva identificadores, firmas, bloques de código y términos PDF en su forma original.
Componente: TPdfView · Unidad: PDFium
Indicador optativo que le dice a la vista que dibuje una pequeña superposición de "Loading..." durante renders largos, para que las aplicaciones que usan su propio worker fuera del hilo principal muestren una señal visual consistente
Sintaxis
property AsyncRendering: Boolean;
Descripción
AsyncRendering es la mitad visual del patrón de render asíncrono: le indica a la ruta de pintura de página única que dibuje un pequeño indicador de carga, configurado con LoadingText y LoadingColor, sobre el área de página renderizada mientras un worker administrado por el llamador genera la página actual. El valor predeterminado es False, así que las aplicaciones existentes se actualizan sin cambios visuales. AsyncRendering no mueve por sí mismo el render a un hilo trabajador. Desde v1.37.0, TPdf serializa por instancia las llamadas de render y descarga de página, así que un worker puede convivir de forma segura con el hilo de la interfaz si respeta ese límite
Notas
La superposición solo se dispara desde la ruta de pintura de una sola página; los modos de pliego dmTwoPageContinuous y dmTwoPageContinuousWithCover no muestran actualmente el indicador. Si necesitas el mismo comportamiento en ambos modos, conecta tu propio OnPaint. Sin un worker que haga trabajo real fuera del hilo principal, AsyncRendering aún dibuja la superposición durante un render sincrónico, lo que puede ser útil para exportaciones de muy alto DPI en equipos lentos, aunque la mayoría de los llamadores lo combinará con TPdfFuture. La ruta de render que usan RenderPage y RenderTile es zero-copy cuando el búfer de destino ya coincide en tamaño y formato de píxel, así que AsyncRendering agrega señal visual sin inflar mucho el costo total
Ejemplo
PdfView1.AsyncRendering := True;
PdfView1.LoadingText := 'Rendering...';
PdfView1.LoadingColor := clGray;
Vea también