FitMode Propiedad

Esta entrada API conserva identificadores, firmas, bloques de código y términos PDF en su forma original.

Controla cómo se sitúa la página actual dentro del área cliente del visor; se vuelve a aplicar automáticamente en Resize y cuando cambia PageNumber para que los documentos largos con tamaños de página mixtos sigan encuadrados

FitMode es el selector estándar de ajuste de página / ajuste de ancho del visor PDF expuesto como propiedad publicada para que las aplicaciones puedan colocar un TPdfView en un formulario y elegir un diseño sin escribir lógica de zoom. Cada valor maps onto a clear visual behaviour:

• pfmNone — manual zoom. Whatever Zoom lo que establezca la aplicación o el usuario final se respeta exactamente. Este es el valor predeterminado para conservar el comportamiento anterior a v1.19.0 en las aplicaciones existentes
• pfmActualSize — 100%. Renders one PDF user unit (1/72 inch) per CSS pixel.
• pfmFitPage — toda la página cabe dentro del área visible. La vista elige el menor de los zoom que encajan por ancho y por alto de la página
• pfmFitWidth — the page width matches the viewport width; height scrolls. Good for long documents read top to bottom.

El modo de ajuste activo se vuelve a aplicar automáticamente cuando el control se redimensiona y cuando cambia la página actual — esa es la clave de FitMode frente a una asignación puntual del zoom. Los documentos con tamaños de página mixtos (por ejemplo una portada vertical seguida de pliegos apaisados) permanecen perfectamente encuadrados sin necesidad de ningún controlador adicional de Resize / OnPageChange.

Establecer Zoom directamente cancela el modo de ajuste activo y vuelve a dejar FitMode en pfmNone, siguiendo la convención estándar de PDF en la que al escribir un porcentaje de zoom se sale de "Fit Page" / "Fit Width". Así el valor de la propiedad sigue siendo fiel: FitMode <> pfmNone significa "la vista se reajustará en el siguiente evento de diseño"

• FitMode NO almacena en caché el Zoom elegido — la matemática se ejecuta cada vez que se vuelve a aplicar el modo de ajuste activo, de modo que cambiar la rotación, redimensionar la ventana o pasar a una página de distinto tamaño siempre produce el zoom correcto
• Combina FitMode = pfmFitWidth con SmoothScroll para conseguir la sensación clásica de "lector de documentos largos"
• Si la aplicación anfitriona quiere exponer una barra de botones "Fit Page" / "Fit Width", basta con asignar FitMode — no hace falta ningún cálculo adicional de Zoom

Zoom, PageZoom, PageWidthZoom, PageHeightZoom, ActualSizeZoom