BeginArtifactEx

PDF מתויג, נגישות

תיאור

פותח רצף תוכן מסומן של ארטיפקט עם סוג ארטיפקט מפורש ותת-סוג Pagination אופציונלי בקריאה אחת, באמצעות מילון המאפיינים והאופרטור BDC הנדרשים לפי ISO 32000-2 §14.8.2.2.1 Table 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;