EndArtifact
ملف PDF ذو بنية، إمكانية الوصول
الوصف
يغلق منطقة العنصر المفتوحة مؤخرًا كاتبةً عامل EMC (إنهاء المحتوى الموسوم) إلى تدفق محتوى الصفحة الحالية. ويجب أن يقابل كل استدعاء لـ BeginArtifact استدعاء EndArtifact واحد بالضبط
الصيغة
Delphi
Function TPDFlib.EndArtifact: Integer;
ActiveX
Function PDFlib::EndArtifact() As Long
DLL
int DLEndArtifact(int InstanceID);
قيم الإرجاع
| 0 | فشل — لا يوجد مستند مفتوح أو لا توجد منطقة عنصر مفتوحة حاليًا |
|---|---|
| 1 | أُغلقت منطقة العنصر بنجاح |
ملاحظات
تتشارك مناطق العناصر وعناصر البنية رصة المحتوى الموسوم نفسها للصفحة الحالية. لا يغلق EndArtifact إلا المنطقة المفتوحة العليا إذا فُتحت بـ BeginArtifact؛ ولا تستخدمه أبدًا لإغلاق عنصر بنية فُتح بـ BeginTag أو تنويعاته — استدعِ EndTag لذلك
يمكن تداخل مناطق العناصر داخل عناصر البنية عندما يمثل العنصر رسمًا زخرفيًا ينتمي بصريًا لمحتوى بنيوي. لكنها لا يجوز أن تحتوي عناصر بنية: ستحذر عارضات PDF أو سترفض احترام البنية داخل عنصر
أنواع فرعية نموذجية للعناصر تبرر منطقة منفصلة هي ترويسات الصفحات وتذييلاتها وأرقامها والحدود الزخرفية والعلامات المائية وصور الخلفية. ووسمها كعناصر يبقيها خارج ترتيب القراءة الذي تعرضه تقنيات المساعدة للمستخدم
مثال
// Running footer drawn once per page, as an artifact
PDF.BeginArtifact('Footer');
PDF.SetFontSize(8);
PDF.PrintText(50, 30, 'Annual Report 2026 — page ' + IntToStr(pageNo));
PDF.EndArtifact;
// Page header with the company logo, also an artifact
PDF.BeginArtifact('Header');
PDF.DrawImage(50, 800, 60, 30, logoHandle);
PDF.EndArtifact;