SetStructElemActualTextA

PDF المُعلَّم وإمكانية الوصول

الوصف

الحرف المُلحق A يُشير إلى نقطة دخول ANSI (char) في DLL؛ بينما تكشف واجهة ActiveX/COM الشكل Unicode فقط. السلوك مطابق لـ SetStructElemActualText وتُفسَّر وسائط السلاسل النصية باستخدام صفحة الرموز الحالية لـ SetAnsiMode

يضبط مدخل /ActualText على عنصر البنية قيد البناء حاليًا على رصة الوسوم. يوفر ActualText نص Unicode الدقيق الذي يمثله العنصر، متجاوزًا أي نص يُستخرج من تدفق محتوى PDF بواسطة برمجيات القراءة

استخدم هذه الدالة عندما لا تترابط الحروف المرسومة في تدفق المحتوى مباشرة بمحارف ترتيب قراءتها المقصودة — مثل حرف رابط‏ (ff وfi وfl) ينبغي أن يُقرأ كتسلسل المحرفين ff أو fi أو fl. وبدون ActualText قد تنتج أدوات استخراج النص وقارئات الشاشة مخرجات خاطئة لمثل هذه الحروف

الصيغة

Delphi

Function DLSetStructElemActualTextA(InstanceID: Integer; ActualText: PAnsiChar): Integer;

DLL

int DLSetStructElemActualTextA(int InstanceID, const char * ActualText);

المعاملات

قيمة الإرجاع

تُرجع 1 عند النجاح، و0 إذا لم يكن هناك عنصر بنية مفتوح حاليًا أو لا يوجد مستند محدد

ملاحظات

استدع هذه الدالة مباشرة بعد BeginTag أو BeginTagEx بينما يكون العنصر المستهدف في أعلى مكدس الوسوم

النص الفعلي الذي يُكتب في مدخل /ActualText (ISO 32000-1 §14.9.4). مرِّر سلسلة فارغة لحذفه

يعرّف ISO 32000-1 §14.9.4 مدخل ActualText كسلسلة نص PDF في قاموس عنصر البنية. ويتطلب PDF/UA-1 (ISO 14289-1 §7.1) أن يكون المحتوى النصي قابلًا للاستخراج وصحيحًا؛ وActualText هو الآلية القياسية لاستيفاء هذا المتطلب لتسلسلات المحارف التي يكون استخراجها المباشر غامضًا أو خاطئًا

مثال

// Tag a ligature glyph so that text extraction yields "fi"
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemActualText('fi');
PDFlib.TextOut(x, y, #$FB01);   // U+FB01 LATIN SMALL LIGATURE FI
PDFlib.EndTag;

انظر أيضا

BeginTag, BeginTagEx, SetStructElemID, AddTagAttribute, GetPDFUADiagnostics