function TextInRectangle(Left, Top, Right, Bottom: Double): WString;
function TextInRectangle(Rectangle: TPdfRectangle): WString;
| Rectangle | TPdfRectangle. رکوردی که مستطیل محاطی را در مختصات فضای کاربر PDF مشخص میکند (مبدأ در پایینچپ، Y به سمت بالا افزایش مییابد) |
WString (رشتهٔ یونیکد) حاوی همهٔ نویسههایی که جعبههای محاطیشان با مستطیل مشخصشده تقاطع دارند. اگر هیچ متنی در ناحیه یافت نشود یک رشتهٔ خالی بازمیگرداندTextInRectangle محتوای متنی یونیکد را که درون یک ناحیهٔ مستطیلی مشخص روی صفحهٔ فعلی قرار میگیرد استخراج میکند. این برای خواندن متن از یک ناحیهٔ خاص مانند سرصفحه، پاصفحه، سلول جدول یا برچسب فیلد بدون پردازش کل صفحه مفید است
دو overload ارائه شده است. شکل چهار-پارامتری مقادیر فردی Left، Top، Right و Bottom را میپذیرد. شکل تکپارامتری یک رکورد TPdfRectangle را میپذیرد، که هنگامی که ناحیه از پیش بهعنوان یک ساختار مستطیل محاسبه شده کارآمد است
مختصات از فضای کاربر PDF استفاده میکنند: مبدأ در گوشهٔ پایینچپ صفحه است و Y به سمت بالا افزایش مییابد. توجه کنید که Bottom در نتیجه برای یک مستطیل با جهتگیری معمول مقداری کوچکتر از Top است. نویسهها اگر جعبههای محاطیشان با ناحیهٔ مشخصشده همپوشانی داشته باشد در نتیجه گنجانده میشوند
مانند Text، این متسد از لایهٔ متنی منطقی صفحه میخواند و روی یک صفحهٔ PDF بارگذاریشده عمل میکند
// 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;