SetStructElemHeaders

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

توضیحات

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

پارامترها

Headers فهرست جداشده با کاما از شناسه‌های عنصر سلول‌های TH که سرستون سطر یا ستون سلول TD یا TH فعلی‌اند. هر شناسه باید با ElemID منطبق باشد که قبلاً در همان سند از طریق SetStructElemID به یک عنصر TH داده شده است. فاصله‌های اطراف کاماها نادیده گرفته می‌شود. مثال: TH-ProductName,TH-Price

Headers	فهرست جداشده با کاما از شناسه‌های عنصر سلول‌های TH که سرستون سطر یا ستون سلول TD یا TH فعلی‌اند. هر شناسه باید با ElemID منطبق باشد که قبلاً در همان سند از طریق SetStructElemID به یک عنصر TH داده شده است. فاصله‌های اطراف کاماها نادیده گرفته می‌شود. مثال: `TH-ProductName,TH-Price`

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

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

ملاحظات

این تابع معادل فراخوانی AddTagAttribute با Owner=Table، Name=Headers و همان فهرست جداشده با کاما از شناسه‌ها به‌عنوان Value است. ویژگی به‌صورت آرایهٔ /Headers از رشته‌های متنی PDF در دیکشنری ویژگی /A عنصر ساختاری نوشته می‌شود

ویژگی /Headers در ISO 32000-1 §14.8.5.7.2 (مالک ویژگی Table) تعریف شده است. برای جدول‌های ساده‌ای که سرصفحه‌های ستون مستقیماً بالای سلول‌های داده‌شان قرار دارند، ویژگی /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