SetStructElemHeadersA

ملف PDF ذو بنية، إمكانية الوصول

الوصف

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

يضبط خاصية /Headers (مالك خصائص الجداول) على عنصر البنية المفتوح حاليًا على رصة الوسوم. تربط الخاصية خلية بيانات أو رأس الجدول الحالية بخلية رأس جدول واحدة أو أكثر محددة بمعرفات عناصرها. ويُستخدم ذلك لوصف بنى جداول معقدة يتعذر استنتاجها من الموضع وحده. استدعِ هذه الدالة بعد BeginTag أو BeginTagEx وقبل EndTag

الصيغة

Delphi

Function DLSetStructElemHeadersA(InstanceID: Integer; Headers: PAnsiChar): Integer;

DLL

int DLSetStructElemHeadersA(int InstanceID, const char * Headers);

المعاملات

قيمة الإرجاع

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

ملاحظات

تكافئ هذه الدالة استدعاء AddTagAttribute مع Owner=Table وName=Headers وقائمة المعرّفات المفصولة بفواصل نفسها كـ Value. وتُكتب الخاصية كمصفوفة /Headers من سلاسل نص PDF في قاموس خصائص /A لعنصر البنية

تُعرَّف خاصية /Headers في ISO 32000-1 §14.8.5.7.2 (مالك خصائص الجداول). وفي الجداول البسيطة التي تكون رؤوس أعمدتها مباشرة فوق خلايا بياناتها، تكون خاصية /Scope المضبوطة عبر SetStructElemScope كافية في الغالب. استخدم /Headers للجداول غير المنتظمة ذات الخلايا الممتدة أو الرؤوس متعددة المستويات

يتطلب PDF/UA-1 (ISO 14289-1 §7.10) ربط كل خلية TD صراحةً بخلايا رؤوسها في الجداول التي يتعذر تحديد الربط من ترتيب القراءة وحده

مثال

// A data cell that spans two logical columns, referencing both headers
PDFlib.BeginTag('TD', '', '', '');
PDFlib.SetStructElemHeaders('TH-ProductName,TH-Price');
PDFlib.DrawText('Widget A  $9.99', 100, 660);
PDFlib.EndTag;

انظر أيضا

SetStructElemID, SetStructElemScope, AddTagAttribute, BeginTag, SetPDFUAMode