CharacterIndexAtPos - TPdfView

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

Komponente: TPdfView · Unit: PDFium

Gibt den Zeichenindex auf der aktuellen Seite zurück, der dem Bildschirmpixel (X, Y) am nächsten liegt, oder -1, wenn kein Zeichen nahe genug ist

Syntax

function CharacterIndexAtPos(X, Y: Integer; ToleranceX, ToleranceY: Double): Integer;

Beschreibung

Gibt den Zeichenindex auf der aktuellen Seite zurück, der dem Bildschirmpixel (X, Y) am nächsten liegt, oder -1, wenn kein Zeichen nahe genug ist

Use in OnMouseDown to initiate text selection.

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.CharacterIndexAtPos(X, Y, PageX, PageY) then
    Caption := Format('pt = (%.2f, %.2f)', [PageX, PageY]);
end;

Siehe auch

DeviceToPage, CurrentCharIndex, CharacterCount