SetStructElemSpaceBefore

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

الوصف

يضبط خاصية /SpaceBefore (مالك خصائص التخطيط) على عنصر البنية المفتوح حاليًا على رصة الوسوم. وتحدد القيمة مقدار الفراغ المضاف قبل العنصر الكتلي — تشبيهًا بـ CSS ‏margin-top أو padding-top. وتكافئ استدعاء AddTagAttribute مع Owner=Layout وName=SpaceBefore والقيمة العددية كسلسلة

الصيغة

Delphi

Function TPDFlib.SetStructElemSpaceBefore(Space: Double): Integer;

ActiveX

Function PDFlib::SetStructElemSpaceBefore(Space As Double) As Long

DLL

int DLSetStructElemSpaceBefore(int InstanceID, double Space);

المعاملات

قيمة الإرجاع

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

ملاحظات

استدعِ هذه الدالة بعد BeginTag أو BeginTagEx وقبل EndTag. تُعرَّف خاصية /SpaceBefore في ISO 32000-1 §14.8.5.4.2 (مالك خصائص التخطيط، الجدول 340)

خصائص التخطيط‏ (SpaceBefore وSpaceAfter وStartIndent وEndIndent) استشارية: تصف التخطيط المرئي المقصود لمحركات إعادة التدفق والتصدير (مثلًا عند إعادة تدفق PDF إلى HTML أو EPUB). ولا تؤثر في المظهر المرسوم لملف PDF نفسه. وتحسين دقة خصائص التخطيط يرفع جودة المخرجات المعاد تدفقها من أدوات إمكانية الوصول

مثال

// Tag a heading with extra space above it
PDFlib.BeginTag('H1', '', '', '');
PDFlib.SetStructElemSpaceBefore(12.0);  // 12 pt above the heading
PDFlib.DrawText('Introduction', 72, 700);
PDFlib.EndTag;

انظر أيضا

SetStructElemSpaceAfter, SetStructElemStartIndent, SetStructElemWritingMode, AddTagAttribute