DeviceToPage - TPdfView

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.

Component: TPdfView · Unit: PDFium

Zet een schermpixel (X, Y) binnen de view om naar een PDF-user-spacepunt op de huidige pagina

Syntaxis

function DeviceToPage(X, Y: Integer; out PageX, PageY: Double): Boolean; overload;

function DeviceToPage(X, Y: Integer; var PageNumber: Integer; var PageX, PageY: Double): Boolean; overload;

function DeviceToPage(Rectangle: TRect): TPdfRectangle; overload;

Beschrijving

Zet een schermpixel (X, Y) binnen de view om naar een PDF-user-spacepunt op de huidige pagina

Geeft False terug wanneer het punt buiten de paginarechthoek valt; gebruik dit in OnMouseDown / OnMouseMove om de cursor naar PDF-coördinaten te mappen

TPdfView onderhoudt de device-to-page transformatie intern op basis van Zoom, Rotation, paginavulling en scrolloffset; deze helpers zijn de veilige openbare interface voor die transformatie

Opmerkingen

Coördinaten zijn in PDF-user-spacepunten (1 pt = 1/72 inch), met oorsprong linksonder op de pagina
Resultaten zijn alleen geldig zolang de huidige pagina de actieve pagina is; daaropvolgende PageNumber :=-toewijzingen maken gecachte coördinaten ongeldig
Deze helpers respecteren de visuele Rotation, zodat een pagina die 90° is gedraaid nog steeds naar de juiste PDF-rechthoek wordt gemapt

Voorbeeld

procedure TForm1.PdfView1MouseDown(Sender: TObject; Button: TMouseButton; Shift: TShiftState; X, Y: Integer);
var
  PageX, PageY: Double;
begin
  if PdfView1.DeviceToPage(X, Y, PageX, PageY) then
    Caption := Format('pt = (%.2f, %.2f)', [PageX, PageY]);
end;

Zie ook

PageToDevice, CharacterIndexAtPos, LinkAnnotationAtPos, WebLinkAtPos