FitMode властивість

FitMode — це стандартний перемикач fit-page / fit-width / fit-height PDF-проглядача, відкритий як публікована властивість, щоб застосунки могли кинути TPdfView на форму й обрати компонування без математики масштабування. Кожне значення відповідає ясній поведінці:

• pfmNone — ручне масштабування. Те Zoom, яке задає застосунок або кінцевий користувач, враховується точно. Це значення за замовчуванням, щоб зберегти поведінку до v1.19.0 для наявних застосунків.
• pfmActualSize — 100%. Рендерить одну користувацьку одиницю PDF (1/72 дюйма) на піксель CSS.
• pfmFitPage — вся сторінка вміщується у вікно перегляду. Подання обирає менше з масштабів fit-width і fit-height сторінки.
• pfmFitWidth — ширина сторінки збігається з шириною вікна перегляду; висота прокручується. Добре для довгих документів, які читають зверху вниз.
• pfmFitHeight — висота сторінки збігається з висотою вікна перегляду; ширина прокручується за потреби. Добре для презентацій і альбомних сторінок.

Активний режим вписування повторно застосовується автоматично, коли елемент змінює розмір і коли змінюється поточна сторінка — в цьому й суть FitMode проти одноразового призначення масштабу. Довгі документи зі змішаними розмірами сторінок (наприклад, портретна обкладинка, за якою йдуть альбомні розвороти) лишаються ідеально врізаними без жодного додаткового обробника Resize / OnPageChange.

Пряме встановлення Zoom скасовує активний режим вписування й повертає FitMode до pfmNone, що відповідає стандартній конвенції PDF-проглядачів, де введення відсотка масштабування виходить із "Fit Page" / "Fit Width" / "Fit Height". Це тримає значення властивості чесним: FitMode <> pfmNone означає "подання знову впишеться під час наступної події компонування".

• FitMode НЕ кешує обраний Zoom — обчислення виконуються щоразу, коли активний режим вписування повторно застосовується, тож зміна обертання, зміна розміру вікна чи перехід до сторінки іншого розміру завжди дає правильний масштаб.
• Поєднуйте FitMode = pfmFitWidth із SmoothScroll для класичного відчуття "читача довгих документів".
• Якщо застосунок-хост хоче показати панель кнопок "Fit Page" / "Fit Width" / "Fit Height", просто призначайте FitMode — додаткових обчислень Zoom не потрібно.