BeginArtifactEx

PDF المُعلَّم، إمكانية الوصول

الوصف

يفتح تسلسل محتوى معلَّم من نوع artifact بنوع artifact صريح ونوع فرعي Pagination اختياري في استدعاء واحد، مستخدمًا قاموس الخصائص والعامل BDC المطلوبين حسب ISO 32000-2 §14.8.2.2.1 Table 363استخدم هذه الدالة لـ artifacts من نوع

Pagination أو Layout أو Page أو Background الخاصة بـ PDF 2.0؛ ويجب أن يلي كل استدعاء ناجح استدعاء EndArtifact مطابق

الصيغة

Delphi

Function TPDFlib.BeginArtifactEx(Const ArtifactType, ArtifactSubtype: WideString): Integer;

ActiveX

Function PDFlib::BeginArtifactEx(ArtifactType As String, ArtifactSubtype As String) As Long

DLL

int DLBeginArtifactEx(int InstanceID, const wchar_t * ArtifactType, const wchar_t * ArtifactSubtype);

المعاملات

ArtifactType	مرّر `Pagination` أو `Layout` أو `Page` أو `Background`، أو سلسلة فارغة لإهمال `/Type`
ArtifactSubtype	نوع فرعي Pagination اختياري، شائعه `Header` و `Footer` و `Watermark` و `PageNum` و `LineNum` و `Redaction` و `Bates`

العامل المُكتب

كلاهما غير فارغ	`/Artifact << /Type /T /Subtype /S >> BDC`
النوع فقط	`/Artifact << /Type /T >> BDC`
النوع الفرعي فقط	`/Artifact << /Subtype /S >> BDC`
كلاهما فارغ	`/Artifact BMC`

إصدار PDF

تتطلب Background و PageNum و LineNum و Redaction و Bates إصدار PDF 2.0 وترفع إصدار ميزات الإخراج تلقائيًا

قيم الإرجاع

0	فشل (لا يوجد مستند مفتوح)
1	فُتح تسلسل الـ artifact بنجاح

مثال

// 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 page background using the PDF 2.0 artifact type
PDF.BeginArtifactEx('Background', '');
PDF.DrawImage(BackgroundImage, 0, 0, PDF.PageWidth, PDF.PageHeight);
PDF.EndArtifact;