FitMode - TPdfView - PDFium Delphi Component

Komponenta: TPdfView · Jedinica: PDFium

Kontrolira kako trenutačna stranica sjedi unutar klijentskog područja preglednika; automatski se ponovno primjenjuje na Resize i kada se PageNumber promijeni kako bi dugi dokumenti s miješanim veličinama stranica ostali uokvireni

Sintaksa

property FitMode: TPdfFitMode;

Opis

FitMode je standardni odabirač prilagodbe-stranici / prilagodbe-širini / prilagodbe-visini PDF preglednika, izložen kao published svojstvo tako da aplikacije mogu spustiti TPdfView na obrazac i odabrati raspored bez pisanja izračuna zuma. Svaka se vrijednost preslikava na jasno vizualno ponašanje:

pfmNone — ručni zum. Koju god vrijednost Zoom aplikacija ili krajnji korisnik postavi, poštuje se točno. Ovo je zadana vrijednost radi očuvanja ponašanja prije v1.19.0 za postojeće aplikacije
pfmActualSize — 100%. Iscrtava jednu PDF korisničku jedinicu (1/72 inča) po CSS pikselu
pfmFitPage — cijela stranica stane unutar prikaza. Prikaz odabire manji od zumova prilagodbe širini i prilagodbe visini stranice
pfmFitWidth — širina stranice podudara se sa širinom prikaza; visina se pomiče. Dobro za duge dokumente koji se čitaju od vrha prema dnu
pfmFitHeight — visina stranice podudara se s visinom prikaza; širina se pomiče po potrebi. Dobro za prezentacije i landscape stranice

Aktivni način prilagodbe ponovno se primjenjuje automatski kada kontrola promijeni veličinu i kada se trenutna stranica promijeni — to je cijela poanta FitModea u usporedbi s jednokratnom dodjelom zuma. Dugi dokumenti s miješanim veličinama stranica (na primjer portretna naslovnica nakon koje slijede landscape stranice) ostaju savršeno uokvireni bez ikakvog dodatnog Resize / OnPageChange rukovatelja

Izravno postavljanje Zoom otkazuje aktivni način prilagodbe i vraća FitMode na pfmNone, u skladu sa standardnom konvencijom PDF preglednika u kojoj unos postotka zuma izlazi iz načina "Prilagodi stranicu" / "Prilagodi širinu" / "Prilagodi visinu". To održava vrijednost svojstva iskrenom: FitMode <> pfmNone znači "prikaz će se ponovno prilagoditi pri sljedećem događaju rasporeda"

Napomene

FitMode NE predmemorira odabrani Zoom — izračun se izvodi svaki put kada se aktivni način prilagodbe ponovno primijeni, pa zamjena rotacije, promjena veličine prozora ili prelazak na stranicu drukčije veličine uvijek daje ispravan zum
Kombinirajte FitMode = pfmFitWidth sa SmoothScroll za klasičan dojam „čitača dugih dokumenata"
Ako aplikacija domaćin želi prikazati traku gumba "Prilagodi stranicu" / "Prilagodi širinu" / "Prilagodi visinu", samo dodijelite FitMode — nije potreban dodatni izračun Zoom

Primjer

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

Vidi također