PDFium Delphi Component Docs

Text الطريقة

المكوّن: TPdf  ·  الوحدة: PDFium
استخراج سلسلة نص من الصفحة. يحدد المعاملان StartIndex و Count الأحرف المطلوب استخراجها. المعامل StartIndex صفري الأساس

الصياغة

function Text(StartIndex: Integer = 0; Count: Integer = MaxInt): WString;

StartIndexInteger. فهرس أول حرف مطلوب استخراجه صفري الأساس. الافتراضي 0 (بداية نص الصفحة).
CountInteger. الحد الأقصى لعدد الأحرف المطلوب استخراجها. الافتراضي MaxInt، الذي يستخرج جميع الأحرف المتبقية من StartIndex إلى نهاية الصفحة

قيمة الإرجاع

كائن WString (سلسلة Unicode) يحتوي الأحرف المستخرجة. يعيد سلسلة فارغة إذا كان StartIndex بعد نهاية نص الصفحة أو إذا لم تحتوِ الصفحة على نص قابل للاستخراج

الوصف

يستخرج Text المحتوى النصي Unicode من الصفحة الحالية بوصفه سلسلة عادية. وهو يقرأ من الطبقة النصية الداخلية للصفحة — الطبقة نفسها التي تستخدمها عارضات PDF للتحديد والبحث — لذا يعكس النتيجة ترتيب القراءة المنطقي الذي تحدده PDFium، وهو ما قد يختلف عن الترتيب البصري في التخطيطات المعقدة

يسمح المعاملان الاختياريان StartIndex و Count باستخراج سلسلة فرعية من نص الصفحة الكامل. يكون StartIndex صفري الأساس؛ وإغفال كلا المعاملين يعيد نص الصفحة بأكمله. استخدم CharacterCount لتحديد العدد الإجمالي للأحرف القابلة للاستخراج على الصفحة قبل استخدام وصول قائم على الفهرس

تستخرج هذه الطريقة النص من صفحة PDF محمَّلة. لا تتفاعل مع كائنات النص المضافة عبر AddText حتى يُحفظ المستند ويُعاد تحميله. لاستخراج نص داخل منطقة مستطيلة محددة، استخدم TextInRectangle بدلًا من ذلك

مثال

// Extract all text from the first page
Pdf1.LoadFromFile('C:\Docs\report.pdf');
Pdf1.PageIndex := 0;
ShowMessage(Pdf1.Text);

// Extract characters 10..29 (20 characters)
var S: WString;
begin
  S := Pdf1.Text(10, 20);
end;

انظر أيضًا

TextInRectangle, CharacterCount, FindFirst, Character