وثائق PDFiumPas

FitMode الخاصية

يحافظ إدخال API هذا على المعرّفات والتواقيع وكتل الكود ومصطلحات PDF بصيغتها الأصلية.
المكون: TPdfView  ·  الوحدة: PDFium
يتحكم في كيفية تموضع الصفحة الحالية داخل منطقة العميل الخاصة بالعارض؛ ويُعاد تطبيقه تلقائيًا عند Resize وعند تغيّر PageNumber حتى تبقى المستندات الطويلة ذات أحجام الصفحات المختلطة مؤطرة بشكل صحيح

الصياغة

property FitMode: TPdfFitMode;

الوصف

FitMode هو محدد fit-page / fit-width القياسي في عارض PDF ويُعرض كخاصية منشورة حتى تتمكن التطبيقات من إسقاط TPdfView على نموذج واختيار التخطيط من دون كتابة حسابات التكبير. كل قيمة تقابل سلوكًا بصريًا واضحًا:

يُعاد تطبيق وضع الملاءمة النشط تلقائيًا عند تغيير حجم التحكم وعند تغيّر الصفحة الحالية — وهذه هي الفكرة كاملة من FitMode مقارنةً بتعيين تكبير لمرة واحدة. تبقى المستندات الطويلة ذات أحجام الصفحات المختلطة، مثل غلاف عمودي يتبعه انتشار أفقي، مؤطرة تمامًا من دون أي معالج إضافي لـ Resize / OnPageChange

يؤدي ضبط Zoom مباشرةً إلى إلغاء وضع الملاءمة النشط وإرجاع FitMode إلى pfmNone، بما يطابق عرف عارض PDF القياسي حيث يؤدي إدخال نسبة تكبير إلى الخروج من "Fit Page" / "Fit Width". وهذا يبقي قيمة الخاصية دقيقة: FitMode <> pfmNone تعني أن "العارض سيعيد الملاءمة عند حدث التخطيط التالي"

ملاحظات

مثال

// تتلاءم الصفحة كاملة داخل منطقة العرض، حتى بعد تغيير الحجم / الصفحة
PdfView1.FitMode := pfmFitPage;

// يطابق عرض الصفحة عرض منطقة العرض — وضع قراءة المستندات الطويلة
PdfView1.FitMode := pfmFitWidth;

// 100% — نقطة PDF واحدة لكل بكسل
PdfView1.FitMode := pfmActualSize;

// يُدخل المستخدم قيمة تكبير → الخروج من وضع الملاءمة
PdfView1.Zoom := 1.5;
Assert(PdfView1.FitMode = pfmNone);

انظر أيضا

Zoom, PageZoom, PageWidthZoom, PageHeightZoom, ActualSizeZoom