FitMode Propriété

FitMode est le sélecteur standard fit-page / fit-width des visionneuses PDF, exposé comme propriété publiée afin que les applications puissent déposer un TPdfView sur un formulaire et choisir une disposition sans écrire de calculs de zoom. Chaque valeur correspond à un comportement visuel clair :

• pfmNone — zoom manuel. Quel que soit le Zoom défini par l'application ou l'utilisateur final, il est respecté exactement. C'est la valeur par défaut afin de préserver le comportement antérieur à v1.19.0 pour les applications existantes
• pfmActualSize — 100%. Renders one PDF user unit (1/72 inch) per CSS pixel.
• pfmFitPage — la page entière tient dans la fenêtre. La vue choisit le plus petit des zooms d'ajustement à la largeur et à la hauteur de page
• pfmFitWidth — la largeur de la page correspond à celle de la fenêtre ; la hauteur défile. Idéal pour les longs documents lus de haut en bas

Le mode d'ajustement actif est réappliqué automatiquement lorsque le contrôle est redimensionné et lorsque la page courante change — c'est tout l'intérêt de FitMode par rapport à une attribution de zoom ponctuelle. Les documents longs avec des tailles de page mixtes (une couverture portrait suivie de doubles pages paysage, par exemple) restent parfaitement cadrés sans gestionnaire supplémentaire de Resize / OnPageChange

Définir Zoom directement annule le mode d'ajustement actif et ramène FitMode à pfmNone, conformément à la convention standard des visionneuses PDF selon laquelle la saisie d'un pourcentage de zoom fait sortir de "Fit Page" / "Fit Width". Cela garde la valeur de la propriété honnête : FitMode <> pfmNone signifie "la vue se réajustera lors du prochain événement de disposition"

• FitMode does NOT cache the chosen Zoom — the math runs every time the active fit mode is re-applied, so swapping rotation, resizing the window, or paging to a differently sized page always produces the correct zoom.
• Combine FitMode = pfmFitWidth with SmoothScroll for the classic "long-document reader" feel.
• If the host application wants to expose a "Fit Page" / "Fit Width" button bar, just assign FitMode — no extra Zoom computation needed.