SetStructElemRowSpan

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

الوصف

يضبط خاصية /RowSpan (مالك خصائص الجداول) على عنصر البنية المفتوح حاليًا على رصة الوسوم. وتدل القيمة على عدد الصفوف التي تمتد عبرها خلية الجدول الحالية. وتكافئ استدعاء AddTagAttribute مع Owner=Table وName=RowSpan والقيمة العددية كسلسلة

الصيغة

Delphi

Function TPDFlib.SetStructElemRowSpan(RowSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemRowSpan(RowSpan As Long) As Long

DLL

int DLSetStructElemRowSpan(int InstanceID, int RowSpan);

المعاملات

قيمة الإرجاع

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

ملاحظات

استدعِ هذه الدالة بعد BeginTag‏ (بنوع وسم TH أو TD) وقبل EndTag. تُعرَّف خاصية /RowSpan في ISO 32000-1 §14.8.5.7.2 (مالك خصائص الجداول، الجدول 337)

تظهر خلايا امتداد الصفوف في جداول تحتاج خلية رأس أو بيانات إلى التمدد رأسيًا عبر صفوف متعددة — مثل رأس صف مشترك بين عدة صفوف بيانات. وتوفير خاصية /RowSpan يتيح لتقنيات المساعدة بناء نموذج الشبكة المنطقي للجدول بشكل صحيح

عندما تمتد خلية أيضًا عبر أعمدة متعددة استخدم SetStructElemColSpan بالتزامن مع هذه الدالة

مثال

// A row header cell spanning two data rows
PDFlib.BeginTag('TH', 'First Quarter', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.SetStructElemRowSpan(2);
PDFlib.DrawText('First Quarter', 72, 680);
PDFlib.EndTag;

انظر أيضا

SetStructElemColSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag