FitMode - TPdfView - PDFium Delphi Component

Компонент: TPdfView · Модул: PDFium

Управлява как текущата страница се настанява в клиентската област на визуализатора; пре-прилага се автоматично при Resize и при промяна на PageNumber, така че дълги документи с различни размери на страниците остават рамкирани

Синтаксис

property FitMode: TPdfFitMode;

Описание

FitMode е стандартният за PDF визуализатори избор fit-page / fit-width / fit-height, разкрит като published свойство, така че приложенията да могат да хвърлят TPdfView върху форма и да избират подредба без да пишат изчисления за zoom. Всяка стойност съответства на ясно визуално поведение:

pfmNone — ръчен zoom. Какъвто и Zoom да зададе приложението или крайният потребител, той се спазва точно. Това е стойността по подразбиране, за да се запази поведението преди v1.19.0 при съществуващите приложения
pfmActualSize — 100%. Рендерира една PDF user единица (1/72 инч) на CSS пиксел
pfmFitPage — цялата страница се побира в изгледа. Изгледът избира по-малкия от zoom за побиране по ширина и zoom за побиране по височина
pfmFitWidth — ширината на страницата съвпада с ширината на изгледа; височината се скролва. Подходящо за дълги документи, четени отгоре надолу
pfmFitHeight — височината на страницата съвпада с височината на изгледа; ширината се скролва при нужда. Подходящо за презентации и пейзажни страници

Активният fit режим се пре-прилага автоматично, когато контролата бъде преоразмерена и когато текущата страница се промени — това е целият смисъл на FitMode срещу еднократно задаване на zoom. Дълги документи с различни размери на страниците (портретна корица, следвана от пейзажни разтвори, например) остават перфектно рамкирани без никакъв допълнителен Resize / OnPageChange handler

Директното задаване на Zoom анулира активния fit режим и връща FitMode на pfmNone, в съответствие със стандартната конвенция на PDF визуализаторите, при която въвеждането на процент за zoom излиза от „Fit Page“ / „Fit Width“ / „Fit Height“. Така стойността на свойството остава честна: FitMode <> pfmNone означава „изгледът ще пре-подравни при следващото събитие за подредба“

Забележки

FitMode НЕ кешира избрания Zoom — изчислението се изпълнява всеки път, когато активният fit режим се пре-приложи, така че смяната на въртене, преоразмеряването на прозореца или преминаването към страница с друг размер винаги дава правилния zoom
Комбинирайте FitMode = pfmFitWidth с SmoothScroll за класическото усещане на „четец на дълги документи“
Ако хост приложението иска да разкрие лента с бутони „Fit Page“ / „Fit Width“ / „Fit Height“, просто задайте FitMode — без допълнителни изчисления на Zoom

Пример

// 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);

Виж също

Zoom, PageZoom, PageWidthZoom, PageHeightZoom, ActualSizeZoom