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, где ввод процентного масштаба выключает режимы «Fit Page» / «Fit Width» / «Fit Height». Это сохраняет честность значения свойства: FitMode <> pfmNone означает «представление выполнит повторную подгонку при следующем событии компоновки»

Remarks

Example

// Whole page fits in viewport, even after resize / page change
PdfView1.FitMode := pfmFitPage;

// Page width matches viewport width — long-document reading mode
PdfView1.FitMode := pfmFitWidth;

// Page height matches viewport height — presentation mode
PdfView1.FitMode := pfmFitHeight;

// 100% — one PDF point per pixel
PdfView1.FitMode := pfmActualSize;

// User types a zoom value → drop out of fit mode
PdfView1.Zoom := 1.5;
Assert(PdfView1.FitMode = pfmNone);

See Also

Zoom, PageZoom, PageWidthZoom, PageHeightZoom, ActualSizeZoom