PDFium Delphi Component Docs

PageColor الخاصية

المكوّن: TPdfView  ·  الوحدة: PDFium
لون الخلفية الذي يُرسم تحت صفحة PDF المصيَّرة، منفصلًا عن خاصية Color لعنصر التحكم المحيط. والافتراضي clWhite لتبقى صفحات PDF بلون الورق الأبيض حتى عندما تكون Color لعنصر التحكم المضيف داكنة وفق السمة

الصياغة

property PageColor: TColor;

الوصف

قبل v1.18.0 كانت صفحة PDF المصيَّرة تستخدم خاصية Color الخاصة بـ TPdfView خلفيةً لها. وكان ذلك مزعجًا للتطبيقات ذات الوضع الداكن: فضبط Color := clBlack لدمج العارض في واجهة داكنة كان يرسم صفحات PDF أيضًا فوق خلفية سوداء، فبدت أي وثيقة ذات مناطق شفافة مشوهة

يفصل PageColor السطحين:

الافتراضي clWhite يعني أن صفحات PDF تُصيَّر بلون الورق الأبيض أينما كانت سمة التطبيق المضيف — أي بمظهر كل قارئات PDF الأخرى. والتطبيقات التي كانت تضبط TPdfView.Color سابقًا لتغيير لون صفحة PDF ينبغي أن تضبط PageColor بدلًا منه؛ فالافتراضي الجديد تحسين صريح للحالة الشائعة

ملاحظات

مثال

// Dark-mode viewer pattern: dark scroll area, paper-white PDF page
PdfView1.Color := clBlack;
PdfView1.PageColor := clWhite;

// Sepia-tinted reader background
PdfView1.PageColor := $00C8E3F4; // BGR — soft amber

// Restore pre-v1.18.0 behavior where Color sets the page background
PdfView1.PageColor := PdfView1.Color;

انظر أيضًا

Color, PageShadowColor, PageShadowSize, PageBorderColor