BeginArtifactEx

標籤式 PDF、協助工具

描述

在一次呼叫中，以明確的工件類型與選擇性的 Pagination 子類型開啟工件標記內容序列，使用 ISO 32000-2 §14.8.2.2.1 Table 363 要求的屬性字典與 BDC 運算子此函式用於

Pagination、Layout、Page 或 PDF 2.0 的 Background 工件；每次成功呼叫之後都必須跟著對應的 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;