SetStructElemScopeA

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

الوصف

الحرف المُلحق A يُشير إلى نقطة دخول ANSI (char) في DLL؛ بينما تكشف واجهة ActiveX/COM الشكل Unicode فقط. السلوك مطابق لـ SetStructElemScope وتُفسَّر وسائط السلاسل النصية باستخدام صفحة الرموز الحالية لـ SetAnsiMode

يضبط خاصية /Scope (مالك خصائص الجداول) على عنصر البنية المفتوح حاليًا على رصة الوسوم. يحدد النطاق ما إذا كانت خلية TH‏ (رأس جدول) تنطبق على عمود أو صف أو كليهما — وهو مطلوب من PDF/UA-1 للجداول ذات خلايا الرؤوس. وتكافئ استدعاء AddTagAttribute مع Owner=Table وName=Scope واسم النطاق كقيمة

الصيغة

Delphi

Function DLSetStructElemScopeA(InstanceID: Integer; Scope: PAnsiChar): Integer;

DLL

int DLSetStructElemScopeA(int InstanceID, const char * Scope);

المعاملات

قيمة الإرجاع

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

ملاحظات

استدعِ هذه الدالة قبل إضافة أي محتوى. واستخدم BeginTag/EndTag وBeginArtifact/EndArtifact لوسم محتوى المستند

يتطلب PDF/UA-1 (ISO 14289-1 §7.10) أن ترتبط خلايا رؤوس الجداول بخلايا بياناتها ارتباطًا واضحًا. وتوفير خاصية /Scope هو الآلية الموصى بها عندما يسمح تخطيط الجدول بذلك

مثال

// Tag a column header cell
PDFlib.BeginTag('TH', 'Product Name', '', '');
PDFlib.SetStructElemScope('Column');
PDFlib.DrawText('Product Name', 100, 700);
PDFlib.EndTag;

// Tag a row header cell
PDFlib.BeginTag('TH', 'Row 1', '', '');
PDFlib.SetStructElemScope('Row');
PDFlib.DrawText('Row 1', 72, 680);
PDFlib.EndTag;

انظر أيضا

AddTagAttribute, SetStructElemBBox, BeginTag, EndTag, SetPDFUAMode