SetStructElemRowSpan

PDF برچسب‌گذاری‌شده، دسترس‌پذیری

توضیحات

ویژگی /RowSpan (مالک ویژگی Table) را روی عنصر ساختاری که فعلاً روی پشتهٔ تگ باز است تنظیم می‌کند. این مقدار نشان می‌دهد سلول جاری جدول چند سطر را پوشش می‌دهد. معادل فراخوانی 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);

پارامترها

RowSpan	تعداد سطرهایی که سلول جاری جدول در بر می‌گیرد؛ باید عدد صحیح مثبت باشد. مقدار 1 یعنی سلول دقیقاً یک سطر را اشغال می‌کند (رفتار پیش‌فرض وقتی RowSpan تنظیم نشده). مقادیر بیشتر از 1 یعنی سلولی که چند سطر را پوشش می‌دهد

مقدار بازگشتی

در صورت موفقیت 1 برمی‌گرداند. اگر سندی باز نباشد یا در حال حاضر هیچ tagای روی tag stack باز نباشد، 0 برمی‌گرداند

ملاحظات

این تابع را پس از BeginTag (با نوع tag TH یا TD) و پیش از EndTag فراخوانی کنید. attribute /RowSpan در ISO 32000-1 §14.8.5.7.2 (Table attribute owner, Table 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