FitMode Proprietà

Controlla come la pagina corrente si colloca nell'area client del visualizzatore; riapplicata automaticamente al Resize e al cambiamento di PageNumber, così i documenti lunghi con pagine di dimensioni miste restano inquadrati

FitMode è il selettore standard adatta-a-pagina / adatta-a-larghezza / adatta-a-altezza dei visualizzatori PDF, esposto come proprietà published così le applicazioni possono depositare un TPdfView su un form e scegliere un layout senza scrivere calcoli di zoom. Ogni valore corrisponde a un comportamento visivo ben definito:

• pfmNone — zoom manuale. Qualunque Zoom impostato dall'applicazione o dall'utente finale viene rispettato esattamente. È il valore predefinito per conservare il comportamento anteriore a v1.19.0 nelle applicazioni esistenti
• pfmActualSize — 100%. Renderizza un'unità utente PDF (1/72 di pollice) per pixel CSS
• pfmFitPage — l'intera pagina entra nel viewport. La vista sceglie lo zoom più piccolo tra l'adattamento in larghezza e quello in altezza
• pfmFitWidth — la larghezza della pagina coincide con la larghezza del viewport; l'altezza scorre. Adatto ai documenti lunghi letti dall'alto in basso
• pfmFitHeight — l'altezza della pagina coincide con l'altezza del viewport; la larghezza scorre quando serve. Adatto a presentazioni e pagine orizzontali

La modalità di adattamento attiva viene riapplicata automaticamente quando il controllo viene ridimensionato e quando cambia la pagina corrente — questo è il senso stesso di FitMode rispetto a un'assegnazione di zoom una tantum. I documenti lunghi con pagine di dimensioni miste (una copertina verticale seguita da pagine orizzontali, per esempio) restano perfettamente inquadrati senza alcun gestore Resize / OnPageChange aggiuntivo

Impostare Zoom direttamente annulla la modalità di adattamento attiva e riporta FitMode a pfmNone, come nella convenzione dei visualizzatori PDF in cui digitare una percentuale di zoom abbandona "Adatta alla pagina" / "Adatta alla larghezza" / "Adatta all'altezza". Ciò mantiene coerente il valore della proprietà: FitMode <> pfmNone significa "la vista si riadatterà al prossimo evento di layout"

• FitMode non mette in cache lo Zoom scelto — il calcolo viene eseguito ogni volta che la modalità di adattamento attiva viene riapplicata, così cambiare rotazione, ridimensionare la finestra o passare a una pagina di dimensioni diverse produce sempre lo zoom corretto
• Combinare FitMode = pfmFitWidth con SmoothScroll per la classica sensazione di "lettore di documenti lunghi"
• Se l'applicazione ospite vuole esporre una barra di pulsanti "Adatta alla pagina" / "Adatta alla larghezza" / "Adatta all'altezza", basta assegnare FitMode — nessun calcolo di Zoom aggiuntivo

Zoom, PageZoom, PageWidthZoom, PageHeightZoom, ActualSizeZoom