EndTag

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

الوصف

يغلق عنصر البنية المفتوح مؤخرًا على رصة الوسوم كاتبةً عامل EMC‏ (إنهاء المحتوى الموسوم) إلى تدفق محتوى الصفحة الحالية وساحبًا العنصر من الرصة. ويجب أن يقابل كل استدعاء لـ BeginTag أو BeginTagEx أو BeginTagEx2 استدعاء EndTag واحد بالضبط قبل حفظ المستند أو إضافة الصفحة التالية

الصيغة

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

قيم الإرجاع

ملاحظات

يجب أن تتداخل الوسوم بنظافة. وكل EndTag يغلق أعمق عنصر بنية مفتوح؛ وترتيب الإغلاق صارمًا عكس ترتيب الفتح، بالطريقة نفسها التي تتداخل بها عناصر الكتل العادية في HTML أو XML

إذا حُفظ مستند مع عنصر بنية واحد أو أكثر ما يزال مفتوحًا يُبلغ GetPDFUADiagnostics عن العدد بالرمز STRUCT-UNCLOSED. وتغيب العناصر غير المغلقة عن شجرة البنية المحفوظة، فتبقى أقسام المحتوى الموسوم الموافقة في كل صفحة بلا أب منطقي — وستتخطاها تقنيات المساعدة

لا تستخدم EndTag أبدًا لإغلاق منطقة عنصر فُتحت بـ BeginArtifact؛ استدعِ EndArtifact لذلك. فالعناصر وعناصر البنية تعيش على رصتي محتوى موسوم مستقلتين

مثال

// Nested structure: a section with a heading and two paragraphs
PDF.BeginTag('Sect', '', '');
  PDF.BeginTag('H1', '', '');
    PDF.PrintText(50, 750, 'Introduction');
  PDF.EndTag;   // H1
  PDF.BeginTag('P', '', '');
    PDF.PrintText(50, 720, 'First paragraph of the introduction.');
  PDF.EndTag;   // P
  PDF.BeginTag('P', '', '');
    PDF.PrintText(50, 690, 'Second paragraph follows in the same section.');
  PDF.EndTag;   // P
PDF.EndTag;     // Sect

انظر أيضا

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics