PDFium Delphi Component Docs

LoadingColor الخاصية

Component: TPdfView  ·  Unit: PDFium
لون تعبئة العنصر النائب “loading” المرسوم بينما ما تزال الصفحة قيد العرض

Syntax

property LoadingColor: TColor; // default clYellow

Description

عندما تكون AsyncRendering بقيمة True يرسم العارض مستطيل عنصر نائب في مركز الصفحة المرئية بينما لا يزال بَيت ماب الصفحة الفعلي قيد التوليد. ويتحكم LoadingColor في خلفية ذلك المستطيل. ويوفر الافتراض clYellow تباينًا عاليًا مقابل بَيت ماب الصفحة الأبيض المعتاد بحيث يظهر المؤشر بوضوح حتى عندما تكون الصفحة قد بدأت الرسم خلفه

لا يُرسم العنصر النائب إلا عندما يكون LoadingText غير فارغ — فالنص هو ما يمنح المستطيل حجمه. وإسناد LoadingText إلى سلسلة فارغة يعطّل الطبقة كليًا بغض النظر عن LoadingColor

تغيير LoadingColor وقت التشغيل ينشط في دورة الرسم التالية. ولا يؤثر اللون في محتوى PDF المصيَّر الفعلي، بل في مؤشر التحميل فقط

Remarks

Example

// Enable an Adobe-style loading badge in the center of the page.
PdfView1.AsyncRendering := True;
PdfView1.LoadingColor := $00E0E0E0; // light gray
PdfView1.LoadingText := 'Rendering page...';

// Switch to a high-contrast badge for accessibility-mode UI.
if AccessibilityHighContrast then
begin
  PdfView1.LoadingColor := clBlack;
  PdfView1.Font.Color := clYellow;
end;

See Also

LoadingText, AsyncRendering, PageColor, Color