CharacterRectangle - TPdf

Cette entrée API conserve identifiants, signatures, blocs de code et termes PDF dans leur forme d’origine.

Component: TPdf · Unit: PDFium

Read-only indexed access to the bounding rectangle of the character in PDF user-space coordinates (origin bottom-left, in points).

Syntax

property CharacterRectangle[CharIndex: Integer]: TPdfRectangle; // read only

Description

Indexed read-only access to the bounding rectangle of the character in PDF user-space coordinates (origin bottom-left, in points). The valid range is 0 .. CharacterCount - 1 for the current page; passing an out-of-range index raises EPdfError.

Characters are returned in their logical reading order — the order in which PDFium parsed the content stream — not necessarily in visual order (right-to-left scripts may appear reversed).

All coordinates are in PDF user-space points with the origin at the bottom-left. Use PdfView1.PointsToScreen or your own coordinate transform when overlaying on a VCL canvas.

Parameters

CharIndex Zero-based character index in the current page (0 .. CharacterCount - 1).

Remarks

CharacterCount resets to 0 when Active is False or no page is open.
Whitespace and control characters are included in the count; filter them in your loop if needed.
PDFium synthesises space characters where the content stream uses positioning rather than explicit whitespace (see CharacterGenerated).

Example

var
  I: Integer;
begin
  for I := 0 to Pdf1.CharacterCount - 1 do
    R := Pdf1.CharacterRectangle[I]; Canvas.TextOut(Round(R.Left), Round(R.Top), Pdf1.Character[I]);
end;

CharacterRectangle property