PDFium Delphi Component Docs

ویژگی FitMode

کامپوننت: TPdfView  ·  واحد: PDFium
کنترل می‌کند صفحهٔ فعلی چگونه در ناحیهٔ کاربری نمایشگر قرار بگیرد؛ هنگام Resize و تغییر PageNumber به‌طور خودکار دوباره اعمال می‌شود تا سندهای بلند با اندازه‌های صفحهٔ متفاوت قاب‌بندی‌شده بمانند

Syntax

property FitMode: TPdfFitMode;

Description

FitMode همان انتخابگر استاندارد جا دادن صفحه / جا دادن عرض نمایشگرهای PDF است که به‌صورت یک ویژگی published ارائه شده تا برنامه‌ها بتوانند یک TPdfView روی فرم بگذارند و بدون نوشتن محاسبات بزرگ‌نمایی چیدمان دلخواه را برگزینند. هر مقدار به یک رفتار بصری روشن نگاشت می‌شود:

حالت جا دادن فعال به‌طور خودکار هنگام تغییر اندازهٔ کنترل و تغییر صفحهٔ جاری دوباره اعمال می‌شود — همین نکتهٔ اصلی FitMode در مقایسه با یک انتساب یک‌بارهٔ بزرگ‌نمایی است. سندهای بلند با اندازه‌های صفحهٔ متفاوت (مثلاً جلد عمودی و پس از آن صفحه‌های افقی پشت‌سرهم) بدون هیچ گردانندهٔ اضافی Resize / OnPageChange همواره کامل قاب‌بندی می‌مانند

انتساب مستقیم Zoom حالت جا دادن فعال را لغو می‌کند و FitMode را به pfmNone بازمی‌گرداند؛ مطابق قرارداد استاندارد نمایشگرهای PDF که تایپ درصد بزرگ‌نمایی از حالت «برازش صفحه» / «برازش عرض» خارج می‌شود. این کار مقدار ویژگی را صادقانه نگه می‌دارد: FitMode <> pfmNone یعنی «نما در رویداد چیدمان بعدی دوباره جا داده می‌شود»

Remarks

Example

// کل صفحه در ناحیهٔ نمایش جا می‌شود، حتی پس از تغییر اندازه / تغییر صفحه
PdfView1.FitMode := pfmFitPage;

// عرض صفحه با عرض ناحیهٔ نمایش برابر می‌شود — حالت خواندن سندهای بلند
PdfView1.FitMode := pfmFitWidth;

// ارتفاع صفحه با ارتفاع ناحیهٔ نمایش برابر می‌شود — حالت ارائه
PdfView1.FitMode := pfmFitHeight;

// 100% — یک نقطهٔ PDF به‌ازای هر پیکسل
PdfView1.FitMode := pfmActualSize;

// کاربر مقدار بزرگ‌نمایی را تایپ می‌کند → خروج از حالت جا دادن
PdfView1.Zoom := 1.5;
Assert(PdfView1.FitMode = pfmNone);

See Also

Zoom, PageZoom, PageWidthZoom, PageHeightZoom, ActualSizeZoom