FitMode Propiedad

Controla cómo se sitúa la página actual dentro del área cliente del visor; se vuelve a aplicar automáticamente al redimensionar y cuando cambia PageNumber, de modo que los documentos largos con páginas de tamaños mezclados permanecen bien enmarcados

FitMode es el selector estándar de los visores PDF (ajustar a página / ajustar al ancho / ajustar al alto) expuesto como propiedad published para que las aplicaciones suelten un TPdfView en un formulario y elijan una disposición sin escribir cálculos de zoom. Cada valor se corresponde con un comportamiento visual claro:

• pfmNone — zoom manual. El Zoom que fijen la aplicación o el usuario final se respeta tal cual. Es el valor por defecto para conservar el comportamiento anterior a v1.19.0 en las aplicaciones existentes
• pfmActualSize — 100%. Renderiza una unidad de usuario PDF (1/72 de pulgada) por píxel CSS
• pfmFitPage — la página completa cabe en el viewport. La vista elige el menor de los zooms de ajuste al ancho y de ajuste al alto
• pfmFitWidth — el ancho de la página coincide con el ancho del viewport; el alto se desplaza con scroll. Ideal para documentos largos que se leen de arriba abajo
• pfmFitHeight — el alto de la página coincide con el alto del viewport; el ancho se desplaza con scroll cuando hace falta. Útil para presentaciones y páginas apaisadas

El modo de ajuste activo se vuelve a aplicar automáticamente cuando el control se redimensiona y cuando cambia la página actual — ese es justamente el sentido de FitMode frente a una asignación de zoom puntual. Los documentos largos con tamaños de página mezclados (una portada vertical seguida de dobles páginas apaisadas, por ejemplo) permanecen perfectamente enmarcados sin ningún handler extra de Resize / OnPageChange

Establecer Zoom directamente cancela el modo de ajuste activo y devuelve FitMode a pfmNone, igual que la convención estándar de los visores PDF donde teclear un porcentaje de zoom sale de «Ajustar a página» / «Ajustar al ancho» / «Ajustar al alto». Así el valor de la propiedad se mantiene honesto: FitMode <> pfmNone significa «la vista volverá a ajustarse en el próximo evento de disposición»

• FitMode NO cachea el Zoom elegido — el cálculo se ejecuta cada vez que el modo de ajuste activo se vuelve a aplicar, de modo que cambiar la rotación, redimensionar la ventana o pasar a una página de otro tamaño siempre produce el zoom correcto
• Combine FitMode = pfmFitWidth con SmoothScroll para la sensación clásica de «lector de documentos largos»
• Si la aplicación anfitriona quiere exponer una barra de botones «Ajustar a página» / «Ajustar al ancho» / «Ajustar al alto», basta con asignar FitMode — no hace falta ningún cálculo extra de Zoom

Zoom, PageZoom, PageWidthZoom, PageHeightZoom, ActualSizeZoom