SetStructElemHeaders

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

الوصف

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

الصيغة

Delphi

Function TPDFlib.SetStructElemHeaders(Const Headers: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemHeaders(Headers As String) As Long

DLL

int DLSetStructElemHeaders(int InstanceID, const wchar_t * 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