PDFium Delphi Component Docs

Propriedade FitMode

Componente: TPdfView  ·  Unidade: PDFium
Controla a forma como a página atual fica dentro da área cliente do visualizador; é reaplicado automaticamente em Resize e quando PageNumber muda, para que documentos longos com tamanhos de página mistos fiquem enquadrados

Syntax

property FitMode: TPdfFitMode;

Description

FitMode é o seletor padrão de ajuste de página / ajuste de largura / ajuste de altura dos visualizadores PDF, exposto como propriedade published para que as aplicações possam largar um TPdfView num formulário e escolher um esquema sem escrever matemática de zoom. Cada valor mapeia para um comportamento visual claro:

O modo de ajuste ativo é reaplicado automaticamente quando o controlo é redimensionado e quando a página atual muda — esse é todo o propósito de FitMode face a uma atribuição de zoom única. Documentos longos com tamanhos de página mistos (uma capa em retrato seguida de páginas paisagem, por exemplo) mantêm-se perfeitamente enquadrados sem qualquer processador Resize / OnPageChange adicional

Definir Zoom diretamente cancela o modo de ajuste ativo e reverte FitMode para pfmNone, seguindo a convenção padrão dos visualizadores PDF em que digitar uma percentagem de zoom sai de "Fit Page" / "Fit Width" / "Fit Height". Isto mantém o valor da propriedade honesto: FitMode <> pfmNone significa "a vista vai reajustar no próximo evento de disposição"

Remarks

Example

// Whole page fits in viewport, even after resize / page change
PdfView1.FitMode := pfmFitPage;

// Page width matches viewport width — long-document reading mode
PdfView1.FitMode := pfmFitWidth;

// Page height matches viewport height — presentation mode
PdfView1.FitMode := pfmFitHeight;

// 100% — one PDF point per pixel
PdfView1.FitMode := pfmActualSize;

// User types a zoom value → drop out of fit mode
PdfView1.Zoom := 1.5;
Assert(PdfView1.FitMode = pfmNone);

See Also

Zoom, PageZoom, PageWidthZoom, PageHeightZoom, ActualSizeZoom