Character - TPdf - PDFiumVCL

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

Component: TPdf · Unit: PDFium

Read-only indexed access to the UTF-16 string form of the character at the given index (typically one code unit, but two for a surrogate pair).

Syntax

property Character[CharIndex: Integer]: WString; // read only

Description

Indexed read-only access to the UTF-16 string form of the character at the given index (typically one code unit, but two for a surrogate pair). 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
    Memo1.Text := Memo1.Text + Pdf1.Character[I];
end;

Character property