BeginArtifactExA

標籤式 PDF、無障礙

描述

結尾的 A 表示 ANSI（char）DLL 進入點；ActiveX/COM 介面只提供 Unicode 形式。行為與 BeginArtifactEx 完全相同，字串參數依目前 SetAnsiMode 的字碼頁解讀

以單一呼叫開啟 PDF artifact 標記內容序列，帶有明確的 artifact 類型與選用的 Pagination 子類型。擴充 BeginArtifact，支援 ISO 32000-1 §14.8.2.2.1 表 330 定義的完整 artifact 屬性字典。

需要同時表達 artifact 類型（Pagination、Layout 或 Page）與 Pagination 子類型（Header、Footer、Side）時，使用此函式

每次 BeginArtifactEx 呼叫之後都必須跟著一次對應的 EndArtifact。

語法

Delphi

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

DLL

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

參數

ArtifactType	寫入 `/Type` 屬性的 artifact 類型名稱。有效值見 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	Artifact sequence opened successfully

範例

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