BeginArtifactExA

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

الوصف

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

يفتح تسلسل محتوى موسوم لعنصر PDF مع نوع عنصر صريح ونوع فرعي Pagination اختياري في استدعاء واحد. ويمد BeginArtifact لدعم قاموس خصائص العنصر الكامل المعرف في ISO 32000-1 §14.8.2.2.1 Table 330

استخدم هذه الدالة عندما تحتاج التعبير عن نوع عنصر‏ (Pagination أو Layout أو Page) ونوع فرعي من Pagination‏ (Header أو Footer أو Watermark أو PageNum أو LineNum) في عامل واحد. وللحالات التي يكفي فيها بُعد واحد يكفي BeginArtifact

يجب أن يقابل كل استدعاء BeginArtifactEx استدعاء EndArtifact موافق

الصيغة

Delphi

Function DLBeginArtifactExA(InstanceID: Integer; ArtifactType, ArtifactSubtype: PAnsiChar): Integer;

DLL

int DLBeginArtifactExA(int InstanceID, const char * ArtifactType, const char * ArtifactSubtype);

المعاملات

ArtifactTypeاسم نوع العنصر المكتوب كخاصية /Type. القيم الصالحة وفق ISO 32000-1 §14.8.2.2.1:
  • Pagination — ترويسة صفحة أو تذييلها أو رقمها أو عنصر ترقيم صفحات آخر
  • Layout — محتوى مدفوع بالتخطيط مثل خطوط الأعمدة وزخرفة الخلفية
  • Page — محتوى صفحة جوهري غير مرتبط بأي بنية منطقية
مرِّر سلسلة فارغة لحذف /Type‏ (يرجع العامل إلى /Subtype فقط أو /Artifact BMC مجردة)
ArtifactSubtypeالنوع الفرعي للترقيم المكتوب كخاصية /Subtype. ذو معنى فقط عندما يكون ArtifactType يساوي Pagination. القيم الشائعة: Header وFooter وWatermark وPageNum وLineNum. مرِّر سلسلة فارغة لحذف /Subtype

المعامل المكتوب

Both non-empty/Artifact << /Type /T /Subtype /S >> BMC
Type only/Artifact << /Type /T >> BMC
Subtype only/Artifact << /Subtype /S >> BMC
Both empty/Artifact BMC

قيم الإرجاع

0فشل (لا يوجد مستند مفتوح)
1فُتح تسلسل العنصر بنجاح

مثال

// Mark a running header as a Pagination artifact with subtype Header
PDF.BeginArtifactEx('Pagination', 'Header');
PDF.PrintText(50, 780, 'Chapter 3  —  Results');
PDF.EndArtifact;

// Mark a column rule as a Layout artifact (no subtype needed)
PDF.BeginArtifactEx('Layout', '');
PDF.DrawLine(300, 50, 300, 750);
PDF.EndArtifact;