FitMode プロパティ

この API エントリでは識別子、シグネチャ、コードブロック、PDF 用語を元の表記のまま保持します。

現在ページをビューアーのクライアント領域内にどのように収めるかを制御します。Resize 時と PageNumber 変更時に自動的に再適用されるため、ページサイズが混在する長い文書でも枠内に保たれます

FitMode is the standard PDF-viewer fit-page / fit-width selector exposed as a published property so applications can drop a TPdfView onto a form and pick a layout without writing zoom math. Each value maps onto a clear visual behaviour:

• pfmNone — manual zoom. Whatever Zoomアプリケーションまたはエンドユーザーが設定した値がそのまま尊重されます。既存アプリケーションの v1.19.0 以前の動作を保つため、これが既定値です
• pfmActualSize — 100%. Renders one PDF user unit (1/72 inch) per CSS pixel.
• pfmFitPage— ページ全体がビューポート内に収まります。ビューはページ幅に合わせるズームとページ高さに合わせるズームの小さい方を選びます
• pfmFitWidth — the page width matches the viewport width; height scrolls. Good for long documents read top to bottom.

アクティブな fit mode は、コントロールのサイズ変更時と現在ページ変更時に自動的に再適用されます。これが一度きりのズーム代入と FitMode の違いです。ページサイズが混在する長い文書 (たとえば縦向き表紙の後に横向き見開きが続く場合) でも、追加の Resize / OnPageChange ハンドラーなしで適切に枠内へ収まります

Setting Zoom directly cancels the active fit mode and reverts FitMode to pfmNone, ズーム率を入力すると「Fit Page」/「Fit Width」から抜ける標準的な PDF ビューアーの慣例に一致します。これによりプロパティ値は実態を保ちます:FitMode <> pfmNoneは「次のレイアウトイベントでビューが再フィットする」ことを意味します

• 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を使うと、従来型の「長文書リーダー」らしい操作感になります
• If the host application wants to expose a "Fit Page" / "Fit Width" button bar, just assign FitMode — no extra Zoom computation needed.

Zoom, PageZoom, PageWidthZoom, PageHeightZoom, ActualSizeZoom