function TextInRectangle(Left, Top, Right, Bottom: Double): WString;
function TextInRectangle(Rectangle: TPdfRectangle): WString;
| Rectangle | TPdfRectangle. Een record dat de begrenzingsrechthoek in PDF-gebruikersruimte-coördinaten specificeert (oorsprong linksonder, Y neemt opwaarts toe). |
WString (Unicode-string) die alle tekens bevat waarvan de begrenzingskaders de opgegeven rechthoek doorsnijden. Retourneert een lege string als geen tekst binnen de regio wordt gevonden.TextInRectangle extraheert de Unicode-tekstinhoud die binnen een opgegeven rechthoekige regio op de huidige pagina valt. Dit is nuttig om tekst uit een specifiek gebied zoals een koptekst, voettekst, tabelcel of veldlabel te lezen zonder de hele pagina te verwerken.
Twee overloads worden aangeboden. De vier-parameter-vorm accepteert individuele Left-, Top-, Right- en Bottom-waarden. De één-parameter-vorm accepteert een TPdfRectangle-record, wat handig is wanneer de regio al als een rechthoekstructuur is berekend.
Coördinaten gebruiken PDF-gebruikersruimte: de oorsprong is in de linkerbenedenhoek van de pagina en Y neemt opwaarts toe. Merk op dat Bottom daarom een kleinere waarde is dan Top voor een normaal georiënteerde rechthoek. Tekens worden in het resultaat opgenomen als hun begrenzingskaders de opgegeven regio overlappen.
Zoals Text leest deze methode vanuit de logische tekstlaag van de pagina en werkt op een geladen PDF-pagina.
// 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;