PDFium Component Docs

Text Methode

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.
Komponente: TPdf  ·  Unit: PDFium
Extrahiert eine Textzeichenkette aus der Seite. Die Parameter StartIndex und Count bestimmen, welche Zeichen extrahiert werden. Der Parameter StartIndex ist 0-basiert.

Syntax

function Text(StartIndex: Integer = 0; Count: Integer = MaxInt): WString;

StartIndexInteger. Nullbasierter Index des ersten zu extrahierenden Zeichens. Standard ist 0 (Anfang des Seitentexts).
CountInteger. Maximale Anzahl der zu extrahierenden Zeichen. Standard ist MaxInt, wodurch alle verbleibenden Zeichen von StartIndex bis zum Seitenende extrahiert werden.

Return Value

Ein WString (Unicode-String) mit den extrahierten Zeichen. Gibt eine leere Zeichenkette zurück, wenn StartIndex hinter dem Ende des Seitentexts liegt oder die Seite keinen extrahierbaren Text enthält.

Beschreibung

Text extrahiert den Unicode-Textinhalt der aktuellen Seite als einfachen String. Er liest aus der internen Textebene der Seite — derselben Ebene, die PDF-Viewer für Textauswahl und Suche verwenden — sodass das Ergebnis die von PDFium bestimmte logische Lesereihenfolge widerspiegelt, die bei komplexen Layouts von der visuellen Reihenfolge abweichen kann.

Die optionalen Parameter StartIndex und Count erlauben das Extrahieren eines Teilstrings aus dem vollständigen Seitentext. StartIndex ist nullbasiert; wenn beide Parameter weggelassen werden, wird der gesamte Seitentext zurückgegeben. Verwenden Sie CharacterCount, um die Gesamtzahl der extrahierbaren Zeichen auf der Seite zu bestimmen, bevor Sie einen indexbasierten Zugriff verwenden.

Diese Methode extrahiert Text aus einer geladenen PDF-Seite. Sie arbeitet nicht mit Textobjekten zusammen, die über AddText hinzugefügt wurden, bis das Dokument gespeichert und erneut geladen wurde. Um Text innerhalb eines bestimmten rechteckigen Bereichs zu extrahieren, verwenden Sie stattdessen TextInRectangle.

Beispiel

// Gesamten Text der ersten Seite extrahieren
Pdf1.LoadFromFile('C:\Docs\report.pdf');
Pdf1.PageIndex := 0;
ShowMessage(Pdf1.Text);

// Zeichen 10..29 extrahieren (20 Zeichen)
var S: WString;
begin
  S := Pdf1.Text(10, 20);
end;

Siehe auch

TextInRectangle, CharacterCount, FindFirst, Character