FitMode Właściwość

FitMode to standardowy przełącznik dopasowania strony PDF (fit-page / fit-width / fit-height) udostępniony jako właściwość published, dzięki czemu aplikacje mogą umieścić TPdfView na formularzu i wybrać układ bez pisania matematyki powiększenia. Każda wartość odpowiada wyraźnemu zachowaniu wizualnemu:

• pfmNone — powiększenie ręczne. Wartość Zoom ustawiona przez aplikację lub użytkownika końcowego jest honorowana dokładnie. To wartość domyślna, zachowująca zachowanie sprzed v1.19.0 dla istniejących aplikacji.
• pfmActualSize — 100%. Renderuje jedną jednostkę użytkownika PDF (1/72 cala) na piksel CSS.
• pfmFitPage — cała strona mieści się w obszarze widoku. Widok wybiera mniejsze z powiększeń dopasowania do szerokości i do wysokości strony.
• pfmFitWidth — szerokość strony pokrywa się ze szerokością obszaru widoku; wysokość przewija. Dobre dla długich dokumentów czytanych od góry do dołu.
• pfmFitHeight — wysokość strony pokrywa się z wysokością obszaru widoku; szerokość przewija się w razie potrzeby. Dobre dla prezentacji i stron poziomych.

Aktywny tryb dopasowania jest ponownie stosowany automatycznie przy zmianie rozmiaru kontrolki i przy zmianie bieżącej strony — to cały sens FitMode w porównaniu z jednorazowym przypisaniem powiększenia. Długie dokumenty o mieszanych rozmiarach stron (na przykład pionowa okładka, po której następują poziome rozwkładówki) pozostają idealnie wykadrowane bez żadnego dodatkowego handlera Resize / OnPageChange.

Bezpośrednie ustawienie Zoom anuluje aktywny tryb dopasowania i przywróci FitMode do pfmNone, zgodnie ze standardową konwencją przeglądarek PDF, gdzie wpisanie procentu powiększenia wychodzi z trybu „Fit Page” / „Fit Width” / „Fit Height”. Dzięki temu wartość właściwości pozostaje uczciwa: FitMode <> pfmNone oznacza „widok ponownie dopasuje się przy następnym zdarzeniu układu”.

• FitMode NIE buforuje wybranego Zoom — obliczenia wykonuje przy każdym ponownym zastosowaniu aktywnego trybu dopasowania, więc zmiana obrotu, zmiana rozmiaru okna lub przejście do strony o innym rozmiarze zawsze daje poprawne powiększenie.
• Połącz FitMode = pfmFitWidth z SmoothScroll, aby uzyskać klasyczne odczucie czytnika długich dokumentów.
• Jeśli aplikacja hosta chce udostępnić pasek przycisków „Fit Page” / „Fit Width” / „Fit Height”, wystarczy przypisać FitMode — żadne dodatkowe obliczenia Zoom nie są potrzebne.