DeviceToPage - TPdfView

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.

Komponente: TPdfView · Unit: PDFium

Wandelt einen Bildschirmpixel (X, Y) innerhalb der Ansicht in einen PDF-Benutzerraum-Punkt auf der aktuellen Seite um

Syntax

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;

Beschreibung

Wandelt einen Bildschirmpixel (X, Y) innerhalb der Ansicht in einen PDF-Benutzerraum-Punkt auf der aktuellen Seite um

Gibt False zurück, wenn der Punkt außerhalb des Seitenrechtecks liegt; verwenden Sie dies in OnMouseDown / OnMouseMove, um den Cursor auf PDF-Koordinaten abzubilden

TPdfView verwaltet die Geräte-zu-Seite-Transformation intern anhand von Zoom, Rotation, Seitenabstand und Scroll-Offset; diese Hilfsfunktionen sind die sichere öffentliche Schnittstelle zu dieser Transformation

Hinweise

Koordinaten sind PDF-User-Space-Punkte (1 pt = 1/72 inch), Ursprung in der linken unteren Ecke der Seite
Die Ergebnisse sind nur gültig, solange die aktuelle Seite die aktive Seite ist; nachfolgende PageNumber := assignments invalidate cached coordinates.
These helpers respect the visual Rotation, sodass eine um 90° gedrehte Seite weiterhin auf das richtige PDF-Rechteck abgebildet wird

Beispiel

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;

Siehe auch

PageToDevice, CharacterIndexAtPos, LinkAnnotationAtPos, WebLinkAtPos