BeginArtifactEx

PDF برچسب‌گذاری‌شده، دسترس‌پذیری

توضیحات

با یک فراخوان، توالی محتوای نشانه‌گذاری‌شدهٔ آرتیفکت را با نوع صریح آرتیفکت و زیرنوع اختیاری Pagination باز می‌کند و از فرهنگ‌واژهٔ ویژگی و عملگر BDC که ISO 32000-2 §14.8.2.2.1، جدول 363 الزامی کرده است استفاده می‌نمایداین تابع را برای آرتیفکت‌های

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	توالی آرتیفکت با موفقیت باز شد

مثال

// 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;