SetStructElemColSpan

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

الوصف

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

الصيغة

Delphi

Function TPDFlib.SetStructElemColSpan(ColSpan: Integer): Integer;

ActiveX

Function PDFlib::SetStructElemColSpan(ColSpan As Long) As Long

DLL

int DLSetStructElemColSpan(int InstanceID, int ColSpan);

المعاملات

قيمة الإرجاع

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

ملاحظات

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

الخلايا الممتدة شائعة في الجداول المعقدة — مثل عنوان عمود يمتد عبر عمودي بيانات. وتوفير خاصية /ColSpan يتيح لتقنيات المساعدة حساب مواضع الخلايا بشكل صحيح وربط الرؤوس بخلايا البيانات عبر شبكة الجدول بأكملها

عندما تمتد خلية أيضًا عبر صفوف متعددة استخدم SetStructElemRowSpan بالتزامن مع هذه الدالة

مثال

// A header cell spanning two columns
PDFlib.BeginTag('TH', 'Q1 and Q2 Revenue', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.SetStructElemColSpan(2);
PDFlib.DrawText('Q1 and Q2 Revenue', 100, 700);
PDFlib.EndTag;

انظر أيضا

SetStructElemRowSpan, SetStructElemScope, AddTagAttribute, BeginTag, EndTag