function TextInRectangle(Left, Top, Right, Bottom: Double): WString;
function TextInRectangle(Rectangle: TPdfRectangle): WString;
| Rectangle | TPdfRectangle. Record che specifica il rettangolo di delimitazione in coordinate user-space PDF (origine in basso a sinistra, Y cresce verso l'alto) |
WString (stringa Unicode) con tutti i caratteri i cui riquadri di delimitazione intersecano il rettangolo specificato. Restituisce una stringa vuota se nella regione non c'è testoTextInRectangle estrae il contenuto di testo Unicode che ricade all'interno di una data regione rettangolare sulla pagina corrente. È utile per leggere il testo da un'area specifica come un'intestazione, un piè di pagina, una cella di tabella o un'etichetta di campo senza elaborare l'intera pagina.
Sono disponibili due overload. La forma a quattro parametri accetta valori individuali Left, Top, Right e Bottom. La forma a parametro singolo accetta un record TPdfRectangle, comodo quando la regione è già calcolata come struttura rettangolare.
Le coordinate usano lo spazio utente PDF: l'origine è nell'angolo inferiore sinistro della pagina e Y cresce verso l'alto. Nota che Bottom è quindi un valore più piccolo di Top per un rettangolo orientato normalmente. I caratteri sono inclusi nel risultato se i loro riquadri di delimitazione si sovrappongono alla regione specificata.
Come Text, questo metodo legge dal livello di testo logico della pagina e opera su una pagina PDF caricata.
// 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;