SetStructElemID

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

الوصف

اسأل مستجيب OCSP الخاص بكل ارتباط

الصيغة

Delphi

Function TPDFlib.SetStructElemID(Const ID: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemID(ID As String) As Long

DLL

int DLSetStructElemID(int InstanceID, const wchar_t * ID);

المعاملات

قيمة الإرجاع

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

ملاحظات

يعرّف ISO 32000-1 §14.7.3.4 مدخل /ID. وتُجمع معرفات جميع العناصر في شجرة أسماء /IDTree مسطحة على جذر شجرة البنية عند حفظ المستند؛ مما يتيح لأدوات إمكانية الوصول والعناصر الأخرى البحث عن العناصر بالمعرف. وتُرتب مدخلات /IDTree هجائيًا حسب سلسلة المعرّف

قائمة مفصولة بفواصل تضم معرفات عناصر خلايا TH التي تمثل رؤوس أعمدة أو صفوف لخلية TD أو TH الحالية. يجب أن يطابق كل معرف ElemID مُسندًا إلى عنصر TH عبر SetStructElemID سابقًا في المستند نفسه. وتُتجاهل الفراغات حول الفواصل. مثال: TH-ProductName,TH-Price

إذا سُند المعرّف نفسه إلى عدة عناصر بنية فالسلوك غير معرّف؛ ولا ينبغي أن يتلقى سوى عنصر واحد لكل معرّف فريد سلسلة المعرّف نفسها

مثال

// Tag a column header cell with an ID for later /Headers reference
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemID('TH-ProductName');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

PDFlib.BeginTag('TH', 'Price', '', '');
PDFlib.SetStructElemID('TH-Price');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Price', 250, 700);
PDFlib.EndTag;

// Tag a data cell referencing both header cells
PDFlib.BeginTag('TD', '', '', '');
PDFlib.SetStructElemHeaders('TH-ProductName,TH-Price');
PDFlib.DrawText('Widget A', 100, 680);
PDFlib.EndTag;

انظر أيضا

SetStructElemHeaders, AddTagAttribute, BeginTag, EndTag, SetPDFUAMode