function TextInRectangle(Left, Top, Right, Bottom: Double): WString;
function TextInRectangle(Rectangle: TPdfRectangle): WString;
| Rectangle | TPdfRectangle. A record specifying the bounding rectangle in PDF user-space coordinates (origin at lower-left, Y increases upward). |
WString (Unicode string) containing all characters whose bounding boxes intersect the specified rectangle. Returns an empty string if no text is found within the region.TextInRectangle mengekstrak konten teks Unicode yang jatuh dalam wilayah persegi panjang tertentu pada halaman saat ini. Ini berguna untuk membaca teks dari area tertentu seperti header, footer, sel tabel, atau label field tanpa memproses seluruh halaman.
Tersedia dua overload. Bentuk empat parameter menerima nilai Left, Top, Right, dan Bottom individual. Bentuk satu parameter menerima record TPdfRectangle, yang nyaman ketika wilayah sudah dihitung sebagai struktur persegi panjang.
Koordinat memakai ruang pengguna PDF: titik asal di sudut kiri-bawah halaman dan Y naik ke atas. Perhatikan bahwa Bottom karenanya adalah nilai lebih kecil dari Top untuk persegi panjang yang berorientasi normal. Karakter disertakan dalam hasil jika kotak pembatasnya tumpang tindih wilayah yang ditentukan.
Seperti Text, metode ini membaca dari lapisan teks logis halaman dan beroperasi pada halaman PDF yang dimuat.
// Ekstrak teks dari area header atas halaman A4
// A4: 595 x 842 pt; header = pita 60 pt teratas
Pdf1.LoadFromFile('C:\Docs\report.pdf');
Pdf1.PageIndex := 0;
var HeaderText: WString;
begin
HeaderText := Pdf1.TextInRectangle(0, 782, 595, 842);
ShowMessage(HeaderText);
end;
// Menggunakan overload TPdfRectangle
var
Rect: TPdfRectangle;
CellText: WString;
begin
Rect.Left := 72; Rect.Bottom := 600;
Rect.Right := 250; Rect.Top := 640;
CellText := Pdf1.TextInRectangle(Rect);
end;