PDFium Delphi Component Docs

AsyncRendering الخاصية

Component: TPdfView  ·  Unit: PDFium
علامة اختيارية تخبر العرض برسم تراكب صغير «جارٍ التحميل...» أثناء عمليات العرض الطويلة بحيث تتشارك التطبيقات التي تستخدم عاملها الخاص للعرض خارج الخيط في ميزة بصرية متسقة

Syntax

property AsyncRendering: Boolean;

Description

AsyncRendering هو النصف البصري لنمط العرض غير المتزامن: فهو يخبر مسار رسم الصفحة الواحدة برسم مؤشر تحميل صغير (مُعدّ عبر LoadingText و LoadingColor) فوق منطقة الصفحة المعروضة بينما يصوّر عامل يملكه المستدعي الصفحة الحالية. القيمة الافتراضية هي False بحيث تُرقّى التطبيقات الحالية دون تغيير بصري

AsyncRendering لا يدفع العرض إلى خيط عامل بذاته. منذ الإصدار v1.37.0، يُسلسل TPdf استدعاءات العرض وتفريغ الصفحة لكل نسخة، بحيث يستطيع عامل التصيير عبر المكوّن نفسه دون تداخل استدعاءات عرض PDFium. لا يزال المستدعي يملك توزيع العامل، وتسليم الصورة النطية، ودورة حياة المستند: لا تحوّر أو تُفرّغ المستند أثناء وجود عرض قيد التنفيذ. استخدم TPdfFuture<T> من FPdfAsync لقيادة العامل، ودع AsyncRendering / LoadingText / LoadingColor تتولى الميزة البصرية أثناء العرض قيد التنفيذ

تراكب التحميل مستطيل صغير يُرسم في مركز منطقة الصفحة، مُحجَّم وفق عنوان LoadingText. التطبيقات التي تحتاج إلى وضع مختلف، أو حركة، أو نسبة مئوية للتقدم يجب أن تُبقي AsyncRendering معطّلًا وتتعامل مع التراكب عبر 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