function TextInRectangle(Left, Top, Right, Bottom: Double): WString;
function TextInRectangle(Rectangle: TPdfRectangle): WString;
| Rectangle | TPdfRectangle. En post der specificerer afgrænsningsrektanglet i PDF-brugerrum-koordinater (origo i nederste venstre, Y vokser opad). |
WString (Unicode-streng) der indeholder alle tegn hvis afgrænsningsbokse skærer det angivne rektangel. Returnerer en tom streng, hvis der ikke findes tekst inden for området.TextInRectangle udtrækker det Unicode-tekstindhold der falder inden for et givet rektangulært område på den aktuelle side. Dette er nyttigt til at læse tekst fra et specifikt område såsom et sidehoved, sidefod, tabelcelle eller feltmærkat uden at behandle hele siden.
To overloads leveres. Fire-parameter-formen accepterer individuelle Left-, Top-, Right- og Bottom-værdier. Enkelt-parameter-formen accepterer en TPdfRectangle-post, hvilket er bekvemt når området allerede er beregnet som en rektangel-struktur.
Koordinater bruger PDF-brugerrum: origo er i sidens nederste venstre hjørne, og Y vokser opad. Bemærk at Bottom derfor er en mindre værdi end Top for et normalt orienteret rektangel. Tegn inkluderes i resultatet, hvis deres afgrænsningsbokse overlapper det angivne område.
Ligesom Text læser denne metode fra sidens logiske tekstlag og opererer på en indlæst PDF-side.
// Extract text from the top header area of an A4 page
// A4: 595 x 842 pt; header = top 60 pt band
Pdf1.LoadFromFile('C:\Docs\report.pdf');
Pdf1.PageIndex := 0;
var HeaderText: WString;
begin
HeaderText := Pdf1.TextInRectangle(0, 782, 595, 842);
ShowMessage(HeaderText);
end;
// Using TPdfRectangle overload
var
Rect: TPdfRectangle;
CellText: WString;
begin
Rect.Left := 72; Rect.Bottom := 600;
Rect.Right := 250; Rect.Top := 640;
CellText := Pdf1.TextInRectangle(Rect);
end;